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

こちらもご覧ください

AcquireCredentialsHandle

PFNPEER_FREE_SECURITY_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphCreate

PeerGraphOpen