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。否则，该函数返回以下值之一。

注意如果删除操作由于文件系统错误而失败，则返回相应的文件系统错误。

返回代码	说明
E_ACCESSDENIED	拒绝访问对等组数据库。确保对等方有权执行此操作。在这种情况下，对等方必须是对等组的原始创建者。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_FOUND	找不到对等组。
PEER_E_NO_KEY_ACCESS	拒绝访问标识或对等组密钥。通常，这是由于包含用户或计算机密钥的文件夹的访问控制列表 (ACL) 不正确导致的。手动重置 ACL 时可能会发生这种情况。

可以从 Microsoft RSA 基础提供程序返回特定于加密的错误。这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

如果删除了对等组，与该组关联的所有句柄将立即无效。作为最佳做法，请确保在调用此函数之前关闭此组的所有句柄。否则，将从使用该数据的所有其他正在运行的对等应用程序中删除此数据，这可能会导致错误和不稳定。

要求	值
最低受支持的客户端	带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	p2p.h
Library	P2P.lib
DLL	P2P.dll