peerCollabDeleteContact 函数 (p2p.h)

PeerCollabDeleteContact 函数从与调用方关联的本地联系人存储中删除联系人。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabDeleteContact(
  [in] PCWSTR pwzPeerName
);

[in] pwzPeerName

指向以零结尾的 Unicode 字符串的指针，该字符串包含要删除的联系人的对等名称。此参数不得为 NULL。无法删除“我”联系人。

如果函数成功，则返回S_OK。否则，该函数返回以下值之一。

返回代码	说明
E_OUTOFMEMORY	内存不足，无法支持此操作。
E_INVALIDARG	其中一个参数无效。

使用 PeerCollabDeleteContact 删除联系人后，订阅提供的状态更新将不再可用于该联系人。如果正在监视联系人 (fWatch 设置为 TRUE) 将引发PEER_EVENT_WATCHLIST_CHANGED。