PeerGroupDelete 函式 (p2p.h)
PeerGroupDelete 函式會刪除與對等群組相關聯的本機數據和憑證。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzGroupPeerName
);
參數
[in] pwzIdentity
Unicode 字串的指標，其中包含開啟指定對等群組的身分識別。 如果此參數為 NULL，實作會使用從 PeerIdentityGetDefault 取得的身分識別。
[in] pwzGroupPeerName
Unicode 字串的指標，其中包含刪除數據之對等群組的對等名稱。 此為必要參數。 您可以在 PeerGroupClose 之前呼叫 PeerGroupGetProperties，或使用 PeerGroupParseInvitation 剖析邀請來取得組名。
傳回值
如果作業成功，則傳回S_OK。 否則，函式會傳回下列其中一個值。
注意 如果刪除作業因為檔案系統錯誤而失敗，則會傳回適當的檔案系統錯誤。
| 傳回碼 | Description |
|---|---|
|
對等群組資料庫的存取遭到拒絕。 請確定對等具有執行這項作業的許可權。 在此情況下，對等必須是對等群組的原始建立者。 |
|
其中一個參數無效。 |
|
找不到對等群組。 |
|
拒絕存取身分識別或對等群組金鑰。 一般而言，這是由包含使用者或計算機密鑰的資料夾 (ACL) 不正確的訪問控制清單所造成。 當 ACL 手動重設時，就會發生這種情況。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* ，並在 Winerror.h 中定義。
備註
如果刪除對等群組，與該群組相關聯的所有句柄都會立即變成無效。 最佳做法是，在呼叫此函式之前，請確定已關閉此群組的所有句柄。 否則，此數據會從使用該數據的所有其他執行中對等應用程式中刪除，這可能會導致錯誤和不穩定。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |