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 を返します。 それ以外の場合、関数は次のいずれかの値を返します。

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

関連項目

PEER_RECORD

PeerFreeData

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupJoin

PeerGroupOpen