PEER_SECURITY_INTERFACE 構造体 (p2p.h)
PEER_SECURITY_INTERFACE構造体は、ピア グラフ API を呼び出してレコードの検証、セキュリティ保護、および解放に使用するセキュリティ インターフェイスを指定します。 さらに、アプリケーションは、セキュリティ サービス プロバイダー (SSP) の実装を含む .DLL へのパスを指定できます。
構文
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 のセキュリティ モジュールの ID を指定します。
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 を開発した場合、アプリケーションで Peer Graphing API を呼び出して、グラフ 作成データベース内のデータにアクセスすることはできません。これを行うと、デッドロックが発生する可能性があります。 代わりに、アプリケーションは情報のキャッシュされたコピーを見る必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP と SP2 [デスクトップ アプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP |
| サポートされている最小のサーバー | サポートなし |
| Header | p2p.h |