Skip to content

Latest commit

 

History

History
127 lines (83 loc) · 5.2 KB

ns-p2p-peer_security_interface.md

File metadata and controls

127 lines (83 loc) · 5.2 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:p2p.peer_security_interface_tag
PEER_SECURITY_INTERFACE (p2p.h)
The PEER_SECURITY_INTERFACE structure specifies the security interfaces that calls to Peer Graphing APIs use to validate, secure, and free records.
*PPEER_SECURITY_INTERFACE
PEER_SECURITY_INTERFACE
PEER_SECURITY_INTERFACE structure [Peer Networking]
PPEER_SECURITY_INTERFACE
PPEER_SECURITY_INTERFACE structure pointer [Peer Networking]
p2p.peer_security_interface
p2p/PPEER_SECURITY_INTERFACE
p2p/peer_security_interface_tag
p2p\peer_security_interface.htm
p2p
b4331cfc-dc1a-490b-b21d-0550f1d3fe33
12/05/2018
*PPEER_SECURITY_INTERFACE, PEER_SECURITY_INTERFACE, PEER_SECURITY_INTERFACE structure [Peer Networking], PPEER_SECURITY_INTERFACE, PPEER_SECURITY_INTERFACE structure pointer [Peer Networking], p2p.peer_security_interface, p2p/PPEER_SECURITY_INTERFACE, p2p/peer_security_interface_tag
p2p.h
Windows
Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack forWindows XP
None supported
Windows
PEER_SECURITY_INTERFACE, *PPEER_SECURITY_INTERFACE
19H1
peer_security_interface_tag
p2p/peer_security_interface_tag
PPEER_SECURITY_INTERFACE
p2p/PPEER_SECURITY_INTERFACE
PEER_SECURITY_INTERFACE
p2p/PEER_SECURITY_INTERFACE
c++
APIRef
kbSyntax
HeaderDef
P2P.h
PEER_SECURITY_INTERFACE

PEER_SECURITY_INTERFACE structure

-description

The PEER_SECURITY_INTERFACE structure specifies the security interfaces that calls to Peer Graphing APIs use to validate, secure, and free records. Additionally, it allows an application to specify the path to the .DLL that contains an implementation of a security service provider (SSP).

-struct-fields

-field dwSize

Specifies the size of the structure. Set the value to sizeof(PEER_SECURITY_INTERFACE). This member is required and has no default value.

-field pwzSspFilename

Specifies the full path and file name of a .DLL that implements the SSP interface. See the SSPI documentation for further information on the SSP interface.

-field pwzPackageName

Specifies the ID of the security module in the SSP to use.

-field cbSecurityInfo

Specifies the byte count of the pbSecurityInfo member. This member is not required if pbSecurityInfo is NULL. However, if pbSecurityInfo is not NULL, this member must have a value.

-field pbSecurityInfo

Pointer to a buffer that contains the information used to create or open a peer graph. This member is optional and can be NULL.

The security data blob pointed to by pbSecurityInfo is copied and then passed to the SSPI function call of AcquireCredentialsHandle.

-field pvContext

Pointer to the security context. This security context is then passed as the first parameter to PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA, and PFNPEER_SECURE_RECORD. This member is optional and can be NULL.

-field pfnValidateRecord

Pointer to a callback function that is called when a record requires validation. This member is optional and can be NULL. If pfnSecureRecord is NULL, this member must also be NULL.

-field pfnSecureRecord

Pointer to a callback function that is called when a record must be secured. This member is optional and can be NULL. If pfnValidateRecord is NULL, this member must also be NULL.

-field pfnFreeSecurityData

Pointer to a callback function used to free any data allocated by the callback pointed to by pfnSecureRecord. This member is optional and can be NULL.

-field pfnAuthFailed

-remarks

If you have developed your own SSP, your application must not call the Peer Graphing API to access data in the graphing database; doing so can lead to a deadlock situation. Instead, the application should look at a cached copy of the information.

-see-also

AcquireCredentialsHandle

PFNPEER_FREE_SECURITY_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphCreate

PeerGraphOpen