PeerIdentityGetFriendlyName 函式 (p2p.h)

PeerIdentityGetFriendlyName 函式會傳回對等識別的易記名稱。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzFriendlyName
);

[in] pwzIdentity

指定要取得易記名稱的對等識別。

[out] ppwzFriendlyName

接收易記名稱的指標。不再需要 ppwzFriendlyName 時，應用程式會負責呼叫 PeerFreeData 來釋放此字串。

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

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_NO_KEY_ACCESS	拒絕對等身分識別或對等群組密鑰的存取。一般而言，這是由包含使用者或計算機密鑰的資料夾 (ACL) 不正確的訪問控制清單所造成。當 ACL 已手動重設時，就會發生這種情況。
PEER_E_NOT_FOUND	找不到符合指定名稱的對等識別。

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於 Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2P.lib
Dll	P2P.dll