PeerGroupGetProperties 関数 (p2p.h)

PeerGroupGetProperties 関数は、指定したグループのプロパティに関する情報を取得します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

[in] hGroup

プロパティが取得されるピアグループを処理します。このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。このパラメーターは必須です。

[out] ppProperties

ピアグループのプロパティに関する情報を含む PEER_GROUP_PROPERTIES 構造体へのポインター。このデータは PeerFreeData で解放する必要があります。このパラメーターは必須です。

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

リターンコード	説明
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	指定した操作を実行するのに十分なメモリがありません。
PEER_E_GROUP_NOT_READY	グループは、ピアグループのプロパティを取得できる状態ではありません。たとえば、 PeerGroupJoin が呼び出されますが、グループデータベースとの同期は完了していません。
PEER_E_INVALID_GROUP	ピアグループへのハンドルが無効です。

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

ピアがピアグループデータベースと同期していない場合、グループプロパティを取得できません。この関数を呼び出す前にピアグループデータベースと同期するには、まず PeerGroupConnect を呼び出します。

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