共用方式為

PeerIdentitySetFriendlyName 函式 (p2p.h)

  • 發行項

PeerIdentitySetFriendlyName 函式會修改指定對等識別的易記名稱。 易記名稱是人類可讀取的名稱。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzFriendlyName
);

參數

[in] pwzIdentity

指定要修改的對等身分識別。

[in] pwzFriendlyName

指定新的易記名稱。 指定 NULL 或空字串，將易記名稱重設為預設值，也就是對等名稱的 Unicode 版本。

傳回值

如果函式呼叫成功，傳回值 會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

另請參閱

PeerIdentityGetFriendlyName