peerCreatePeerName 函式 (p2p.h)
PeerCreatePeerName 函式會根據指定的對等識別和分類器的現有名稱來建立新的名稱。 不過，對 PeerCreatePeerName 的呼叫不會建立新的身分識別。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzClassifier,
[out] PWSTR *ppwzPeerName
);
參數
[in] pwzIdentity
指定要作為新對等名稱基礎的身分識別。 如果 pwzIdentity 為 NULL，則建立的名稱不是以任何對等身分識別為基礎，因此是不安全的名稱。
如果 pwzClassifier 不是 NULL，則此參數只能是 NULL。
[in] pwzClassifier
包含新分類器的 Unicode 字串指標。 這個分類器會附加至指定身分識別之對等名稱的現有授權部分。 此字串長度為 150 個字元，包括 NULL 終止符。 指定 NULL 以傳回身分識別的對等名稱。
如果 pwzIdentity 不是 NULL，此參數只能是 NULL。
[out] ppwzPeerName
接收新對等名稱指標的指標。 不再需要此字串時，請呼叫 PeerFreeData來釋出它。
傳回值
如果函式呼叫成功，傳回值 會S_OK。 否則，它會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
備註
呼叫 PeerCreatePeerName 函式之前，參數 ppwzPeername 必須設定為 null。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |