PEER_SECURITY_INTERFACE-Struktur (p2p.h)
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 |