PeerGroupDeleteRecord 関数 (p2p.h)

PeerGroupDeleteRecord 関数は、ピアグループからレコードを削除します。作成者と管理ロールの他のメンバーは、特定のレコードを削除できます。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDeleteRecord(
  [in] HGROUP     hGroup,
  [in] const GUID *pRecordId
);

[in] hGroup

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

[in] pRecordId

削除するレコードを一意に識別する GUID 値を指定します。このパラメーターは必須です。

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

リターンコード	説明
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