次の方法で共有

PeerGroupDelete 関数 (p2p.h)

  • [アーティクル]

PeerGroupDelete 関数は、ピア グループに関連付けられているローカル データと証明書を削除します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzGroupPeerName
);

パラメーター

[in] pwzIdentity

指定したピア グループを開く ID を含む Unicode 文字列へのポインター。 このパラメーターが NULL の場合、実装では PeerIdentityGetDefault から取得された ID が使用されます。

[in] pwzGroupPeerName

データが削除されるピア グループのピア名を含む Unicode 文字列へのポインター。 このパラメーターは必須です。 グループ名は、PeerGroupClose より前に PeerGroupGetProperties を呼び出すか、PeerGroupParseInvitation で招待を解析することで取得できます。

戻り値

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

メモ ファイル システム エラーが原因で削除操作が失敗した場合は、適切なファイル システム エラーが返されます。
 
リターン コード 説明
E_ACCESSDENIED
 ピア グループ データベースへのアクセスが拒否されました。 ピアにこの操作を実行するアクセス許可があることを確認します。 この場合、ピアはピア グループの元の作成者である必要があります。
E_INVALIDARG
 パラメーターの 1 つが無効です。
PEER_E_NOT_FOUND
 ピア グループが見つかりません。
PEER_E_NO_KEY_ACCESS
 ID またはピア グループ キーへのアクセスは拒否されます。 通常、これは、ユーザーまたはコンピューター のキーを含むフォルダーのアクセス制御リスト (ACL) が正しくないことが原因で発生します。 これは、ACL が手動でリセットされるときに発生する可能性があります。
 

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

こちらもご覧ください

PeerGroupCreate