PeerIdentitySetFriendlyName 関数 (p2p.h)
PeerIdentitySetFriendlyName 関数は、指定されたピア ID のフレンドリ名を変更します。 フレンドリ名は、人間が判読できる名前です。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzFriendlyName
);
パラメーター
[in] pwzIdentity
変更するピア ID を指定します。
[in] pwzFriendlyName
新しいフレンドリ名を指定します。 NULL または空の文字列を指定して、フレンドリ名を既定値 (ピア名の Unicode バージョン) にリセットします。
戻り値
関数呼び出しが成功した場合、戻り値は S_OK。 それ以外の場合は、次のいずれかの値が返されます。
| リターン コード | 説明 |
|---|---|
|
パラメーターの 1 つが無効です。 |
|
指定した操作を実行するのに十分なメモリがありません。 |
|
ピア ID またはピア グループ キーへのアクセスが拒否されます。 通常、これは、ユーザーまたはコンピューター のキーを含むフォルダーのアクセス制御リスト (ACL) が正しくないことが原因で発生します。 これは、ACL が手動でリセットされた場合に発生する可能性があります。 |
|
指定した名前と一致するピア ID が見つかりません。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP と SP2 [デスクトップ アプリのみ]、Windows XP 用 Advanced Networking Pack を使用した SP1 の Windows XP |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |