PeerGraphCreate 関数 (p2p.h)

[アーティクル]
08/25/2023

PeerGraphCreate 関数は、新しいピアグラフを作成します。アプリケーションでは、ピアグラフに関する情報と、ピアグラフで使用されるセキュリティの種類を指定できます。ピアグラフへのハンドルが返されますが、ネットワーク接続が確立されていません。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphCreate(
  [in]  PPEER_GRAPH_PROPERTIES   pGraphProperties,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [out] HGRAPH                   *phGraph
);

パラメーター

[in] pGraphProperties

PEER_GRAPH_PROPERTIES構造内のピアグラフのすべてのプロパティ。

[in] pwzDatabaseName

ピアグラフの作成時に関連付けるレコードデータベースの名前。レコードデータベース名は有効なファイル名である必要があります。ファイル名を含むパスは含めないでください。ファイル名に関する規則の完全な一覧については、「 Graphing Reference_Links」の一覧の「ファイルの名前付け」項目を参照してください。

[in] pSecurityInterface

PEER_SECURITY_INTERFACE構造のピアグラフのセキュリティプロバイダーに関する情報。

[out] phGraph

作成されたピアグラフへのハンドルを受け取ります。このハンドルが不要になった場合は、 PeerGraphClose を呼び出して解放します。

戻り値

操作が成功 した場合S_OK を返します。それ以外の場合、関数は次のいずれかの値を返します。

リターンコード	説明
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	指定した操作を実行するのに十分なメモリがありません。
PEER_E_DUPLICATE_GRAPH	指定したピアグラフ ID が既に存在するデータベース。
PEER_E_NOT_INITIALIZED	ピアグラフは、この関数を使用する前に PeerGraphStartup の呼び出しで初期化する必要があります。

注釈

独自のセキュリティサービスプロバイダー (SSP) を開発する場合、アプリケーションは Peer Graphing API を呼び出してピアグラフデータベース内のデータにアクセスしないでください。これはデッドロックの状況を引き起こす可能性があるためです。代わりに、アプリケーションは情報のキャッシュされたコピーを使用する必要があります。キャッシュされたコピーは、Peer Graphing API によって作成されません。アプリケーションは、このデータをキャッシュするためのメカニズムを提供する必要があります。

PeerGraphCreate が呼び出されると、アプリケーションは PeerGraphListen を呼び出す前にイベントをサブスクライブできます。

要件

要件	値
サポートされている最小のクライアント	Windows XP と SP2 [デスクトップアプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	p2p.h
Library	P2PGraph.lib
[DLL]	P2PGraph.dll