PEER_SECURITY_INTERFACE-Struktur (p2p.h)

  • Artikel

Die PEER_SECURITY_INTERFACE-Struktur gibt die Sicherheitsschnittstellen an, die Aufrufe von Peer Graphing-APIs zum Überprüfen, Sichern und Freigeben von Datensätzen verwenden. Darüber hinaus kann eine Anwendung den Pfad zum .DLL angeben, der eine Implementierung eines Sicherheitsdienstanbieters (Security Service Provider, SSP) enthält.

Syntax

typedef struct peer_security_interface_tag {
  DWORD                           dwSize;
  PWSTR                           pwzSspFilename;
  PWSTR                           pwzPackageName;
  ULONG                           cbSecurityInfo;
  PBYTE                           pbSecurityInfo;
  PVOID                           pvContext;
  PFNPEER_VALIDATE_RECORD         pfnValidateRecord;
  PFNPEER_SECURE_RECORD           pfnSecureRecord;
  PFNPEER_FREE_SECURITY_DATA      pfnFreeSecurityData;
  PFNPEER_ON_PASSWORD_AUTH_FAILED pfnAuthFailed;
} PEER_SECURITY_INTERFACE, *PPEER_SECURITY_INTERFACE;

Member

dwSize

Gibt die Größe der Struktur an. Legen Sie den Wert auf sizeof(PEER_SECURITY_INTERFACE) fest. Dieser Member ist erforderlich und hat keinen Standardwert.

pwzSspFilename

Gibt den vollständigen Pfad und Dateinamen einer .DLL an, die die SSP-Schnittstelle implementiert. Weitere Informationen zur SSP-Schnittstelle finden Sie in der SSPI-Dokumentation .

pwzPackageName

Gibt die ID des zu verwendenden Sicherheitsmoduls im SSP an.

cbSecurityInfo

Gibt die Byteanzahl des pbSecurityInfo-Elements an. Dieser Member ist nicht erforderlich, wenn pbSecurityInfoNULL ist. Wenn pbSecurityInfo jedoch nicht NULL ist, muss dieses Member über einen Wert verfügen.

pbSecurityInfo

Zeiger auf einen Puffer, der die Informationen enthält, die zum Erstellen oder Öffnen eines Peerdiagramms verwendet werden. Dieser Member ist optional und kann NULL sein.

Das von pbSecurityInfo angezeigte Sicherheitsdatenblob wird kopiert und dann an den SSPI-Funktionsaufruf von AcquireCredentialsHandle übergeben.

pvContext

Zeiger auf den Sicherheitskontext. Dieser Sicherheitskontext wird dann als erster Parameter an PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA und PFNPEER_SECURE_RECORD übergeben. Dieser Member ist optional und kann NULL sein.

pfnValidateRecord

Zeiger auf eine Rückruffunktion, die aufgerufen wird, wenn ein Datensatz eine Überprüfung erfordert. Dieser Member ist optional und kann NULL sein. Wenn pfnSecureRecordNULL ist, muss auch dieses Element NULL sein.

pfnSecureRecord

Zeiger auf eine Rückruffunktion, die aufgerufen wird, wenn ein Datensatz gesichert werden muss. Dieser Member ist optional und kann NULL sein. Wenn pfnValidateRecordNULL ist, muss auch dieses Element NULL sein.

pfnFreeSecurityData

Zeiger auf eine Rückruffunktion, die verwendet wird, um alle Daten frei zu geben, die vom Rückruf zugeordnet sind, auf den pfnSecureRecord verweist. Dieser Member ist optional und kann NULL sein.

pfnAuthFailed

Hinweise

Wenn Sie einen eigenen SSP entwickelt haben, darf Ihre Anwendung die Peer Graphing-API nicht aufrufen, um auf Daten in der Graphingdatenbank zuzugreifen. Dies kann zu einer Deadlocksituation führen. Stattdessen sollte sich die Anwendung eine zwischengespeicherte Kopie der Informationen ansehen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server) Nicht unterstützt
Kopfzeile p2p.h

Weitere Informationen

AcquireCredentialsHandle

PFNPEER_FREE_SECURITY_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphErstellen

PeerGraphOpen