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