PEER_SECURITY_INTERFACE struttura (p2p.h)

Articolo
03/15/2023

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