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