PeerGroupGetRecord 関数 (p2p.h)
PeerGroupGetRecord 関数は、特定のグループ レコードを取得します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
[in] HGROUP hGroup,
[in] const GUID *pRecordId,
[out] PPEER_RECORD *ppRecord
);
パラメーター
[in] hGroup
特定のレコードを含むグループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。 このパラメーターは必須です。
[in] pRecordId
ピア グループ内の必要なレコードを一意に識別する GUID 値を指定します。 このパラメーターは必須です。
[out] ppRecord
返されたレコードを含む PEER_RECORD 構造体のアドレスへのポインター。 この構造体は、 ポインターを PeerFreeData に渡すことによって解放されます。 このパラメーターは必須です。
戻り値
操作が成功 した場合S_OK を返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
パラメーターの 1 つが無効です。 |
|
指定した操作を実行するのに十分なメモリがありません。 |
|
ピア グループは、グループ レコードを取得できる状態ではありません。 たとえば、 PeerGroupJoin が呼び出されますが、ピア グループ データベースとの同期は完了していません。 |
|
ピア グループへのハンドルが無効です。 |
|
指定された ID と一致するレコードがピア グループ データベースに見つかりません。 |
暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。
要件
| サポートされている最小のクライアント | Windows XP と SP2 [デスクトップ アプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |