PeerCollabSetEndpointName 関数 (p2p.h)

PeerCollabSetEndpointName 関数は、ピアアプリケーションで使用されている現在のエンドポイントの名前を設定します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetEndpointName(
  [in] PCWSTR pwzEndpointName
);

[in] pwzEndpointName

現在のエンドポイントの新しい名前へのポインター。0 で終わる Unicode 文字列として表されます。新しい名前が現在の名前と同じ場合、エラーが発生します。エンドポイント名は 255 文字の Unicode 文字に制限されています。

関数が成功した場合は、S_OKを返します。それ以外の場合、関数は次のいずれかの値を返します。

リターンコード	説明
E_OUTOFMEMORY	この操作をサポートするのに十分なメモリがありません。
E_INVALIDARG	引数の 1 つが無効です。
PEER_E_NOT_SIGNED_IN	この操作では、ユーザーがサインインする必要があります。

既定では、エンドポイント名はマシン名に設定されます。ただし、 PeerCollabSetEndpointName 関数によって設定された新しいエンドポイント名は、再起動後も保持されます。