PeerGroupStartup 関数 (p2p.h)

PeerGroupStartup 関数は、要求されたバージョンのピアインフラストラクチャを使用してピアグループを開始します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

[in] wVersionRequested

呼び出し元がサポートできるピアインフラストラクチャの最上位バージョンを指定します。上位バイトは、マイナーバージョン (リビジョン) 番号を指定します。下位バイトはメジャーバージョン番号を指定します。このパラメーターは必須です。

[out] pVersionData

ピアインフラストラクチャによって提供される特定のレベルのサポートを含む PEER_VERSION_DATA構造体へのポインター。このパラメーターは必須です。

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

リターンコード	説明
ERROR_SERVICE_DEPENDENCY_FAIL	PeerGroupStartup を呼び出す前に、ピア名解決プロトコル (PNRP) サービスを開始する必要があります。
E_OUTOFMEMORY	操作を完了するのに十分なメモリがありません。
PEER_E_IPV6_NOT_INSTALLED	IPv6 がコンピューターにインストールされていないため、グループ化サービスを開始できませんでした。
PEER_E_UNSUPPORTED_VERSION	要求されたバージョンは、インストールされているピアサブシステムではサポートされていません。

暗号化固有のエラーは、 Microsoft RSA ベースプロバイダーから返すことができます。これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

この関数を呼び出す前に、ピア名解決プロトコル (PNRP) サービスを開始する必要があります。

この関数は、他のピアグループ化関数を呼び出す前に、アプリケーションによって呼び出されます。

このリリースでは、アプリケーションは要求されたバージョンとして PEER_GROUP_VERSION を使用する必要があります。

この関数で開始されたピアグループは、アプリケーションの終了時に PeerGroupShutdown を呼び出すことによって閉じられます。

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