peerCollabDeleteContact 函式 (p2p.h)

PeerCollabDeleteContact 函式會從與呼叫端相關聯的本機聯繫人存放區中刪除聯繫人。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabDeleteContact(
  [in] PCWSTR pwzPeerName
);

[in] pwzPeerName

以零結尾的 Unicode 字串指標，其中包含要刪除之聯繫人的對等名稱。此參數不得為 NULL。您無法刪除「我」連絡人。

如果函式成功，則傳回S_OK。否則，函式會傳回下列其中一個值。

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法支援此作業。
E_INVALIDARG	其中一個自變數無效。

使用 PeerCollabDeleteContact 刪除聯繫人之後，訂用帳戶所提供的目前狀態更新將無法再供該聯繫人使用。如果正在監看聯繫人， (fWatch 設定為 TRUE) 將會引發PEER_EVENT_WATCHLIST_CHANGED。