PeerGroupUpdateRecord 関数 (p2p.h)

PeerGroupUpdateRecord 関数は、特定のピアグループ内のレコードを更新します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUpdateRecord(
  [in] HGROUP       hGroup,
  [in] PPEER_RECORD pRecord
);

[in] hGroup

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

[in] pRecord

hGroup の更新されたレコードを含むPEER_RECORD構造体へのポインター。このパラメーターは必須です。

PEER_RECORDの次のメンバーを更新できます。

PEER_RECORD内の次のメンバーが存在する必要がありますが、変更することはできません。

次のメンバーは、値が設定されている場合は無視されます。

残っているメンバーは省略可能です。

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

リターンコード	説明
E_INVALIDARG	指定されたパラメーターのいずれかが無効です。
PEER_E_GROUP_NOT_READY	ピアグループは、レコードを更新できる状態ではありません。たとえば、 PeerGroupJoin が呼び出されましたが、ピアグループデータベースとの同期は完了していません。
PEER_E_INVALID_GROUP	ピアグループへのハンドルが無効です。
PEER_E_NOT_AUTHORIZED	現在のピア ID には、レコードを削除する承認がありません。この場合、ピア ID はレコードの作成者ではありません。
PEER_E_RECORD_NOT_FOUND	レコードをデータストアに配置できません。

暗号化固有のエラーは、 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