PEER_SECURITY_INTERFACE 結構 (p2p.h)

發行項
03/05/2024

PEER_SECURITY_INTERFACE 結構會指定呼叫對等圖形 API 的安全性介面，以驗證、保護及釋放記錄。此外，它可讓應用程式指定包含安全性服務提供者實作 .DLL 的路徑， (SSP) 。

語法

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;

成員

dwSize

指定結構的大小。將值設定為sizeof (PEER_SECURITY_INTERFACE) 。此成員為必要專案，且沒有預設值。

pwzSspFilename

指定實作 SSP 介面之 .DLL 的完整路徑和檔名。如需 SSP 介面的詳細資訊，請參閱 SSPI 檔。

pwzPackageName

指定要使用之 SSP 中安全性模組的識別碼。

cbSecurityInfo

指定 pbSecurityInfo 成員的位元組計數。如果 pbSecurityInfo 為 NULL，則不需要此成員。不過，如果 pbSecurityInfo 不是 NULL，則此成員必須具有值。

pbSecurityInfo

緩衝區的指標，其中包含用來建立或開啟對等圖形的資訊。此成員是選擇性的，可以是 NULL。

pbSecurityInfo 所指向的安全性數據 Blob 會複製，然後傳遞至 AcquireCredentialsHandle 的 SSPI 函式呼叫。

pvContext

安全性內容的指標。然後，此安全性內容會當做第一個參數傳遞至 PFNPEER_VALIDATE_RECORD、 PFNPEER_FREE_SECURITY_DATA和 PFNPEER_SECURE_RECORD。此成員是選擇性的，可以是 NULL。

pfnValidateRecord

當記錄需要驗證時呼叫的回呼函式指標。此成員是選擇性的，可以是 NULL。如果 pfnSecureRecord 為 NULL，此成員也必須是 NULL。

pfnSecureRecord

必須保護記錄時所呼叫回呼函式的指標。此成員是選擇性的，可以是 NULL。如果 pfnValidateRecord 為 NULL，此成員也必須是 NULL。

pfnFreeSecurityData

回呼函式的指標，用來釋放 pfnSecureRecord 所指向之回呼所配置的任何數據。此成員是選擇性的，可以是 NULL。

pfnAuthFailed

備註

如果您已經開發自己的 SSP，您的應用程式不得呼叫對等圖形 API 來存取圖形資料庫中的數據;這樣做可能會導致死結情況。相反地，應用程式應該查看資訊的快取複本。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器	都不支援
標頭	p2p.h