PEER_SECURITY_INTERFACE struttura (p2p.h)
La struttura PEER_SECURITY_INTERFACE specifica le interfacce di sicurezza che chiamano le API peer graphing usate per convalidare, proteggere e liberare record. Consente inoltre a un'applicazione di specificare il percorso del .DLL che contiene un'implementazione di un provider di servizi di sicurezza .
Sintassi
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;
Members
dwSize
Specifica le dimensioni della struttura. Impostare il valore su sizeof(PEER_SECURITY_INTERFACE). Questo membro è obbligatorio e non ha alcun valore predefinito.
pwzSspFilename
Specifica il percorso completo e il nome del file di un .DLL che implementa l'interfaccia SSP. Per altre informazioni sull'interfaccia SSP, vedere la documentazione di SSPI .
pwzPackageName
Specifica l'ID del modulo di sicurezza nel provider di servizi di sicurezza da usare.
cbSecurityInfo
Specifica il numero di byte del membro pbSecurityInfo . Questo membro non è obbligatorio se pbSecurityInfo è NULL. Tuttavia, se pbSecurityInfo non è NULL, questo membro deve avere un valore.
pbSecurityInfo
Puntatore a un buffer contenente le informazioni usate per creare o aprire un grafico peer. Questo membro è facoltativo e può essere NULL.
Il BLOB di dati di sicurezza a cui fa riferimento pbSecurityInfo viene copiato e quindi passato alla chiamata di funzione SSPI di AcquireCredentialsHandle.
pvContext
Puntatore al contesto di sicurezza. Questo contesto di sicurezza viene quindi passato come primo parametro a PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA e PFNPEER_SECURE_RECORD. Questo membro è facoltativo e può essere NULL.
pfnValidateRecord
Puntatore a una funzione di callback chiamata quando un record richiede la convalida. Questo membro è facoltativo e può essere NULL. Se pfnSecureRecord è NULL, questo membro deve essere NULL.
pfnSecureRecord
Puntatore a una funzione di callback chiamata quando è necessario proteggere un record. Questo membro è facoltativo e può essere NULL. Se pfnValidateRecord è NULL, questo membro deve essere NULL.
pfnFreeSecurityData
Puntatore a una funzione di callback usata per liberare i dati allocati dal callback a cui fa riferimento pfnSecureRecord. Questo membro è facoltativo e può essere NULL.
pfnAuthFailed
Commenti
Se è stato sviluppato il proprio SSP, l'applicazione non deve chiamare l'API Peer Graphing per accedere ai dati nel database di grafo; in questo modo può causare una situazione di deadlock. L'applicazione deve invece esaminare una copia memorizzata nella cache delle informazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP |
| Server minimo supportato | Nessuno supportato |
| Intestazione | p2p.h |