PeerCollabSetPresenceInfo 関数 (p2p.h)
PeerCollabSetPresenceInfo 関数は、呼び出し元のプレゼンス情報を、それを監視している連絡先に更新します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
[in] PCPEER_PRESENCE_INFO pcPresenceInfo
);
パラメーター
[in] pcPresenceInfo
呼び出し 元ピア アプリケーション 用に発行する新しいプレゼンス情報を含むPEER_PRESENCE_INFO構造体へのポインター。
戻り値
関数が成功した場合は、S_OKを返します。 それ以外の場合、関数は次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
この操作をサポートするのに十分なメモリがありません。 |
|
引数の 1 つが無効です。 |
|
Windows ピア インフラストラクチャが初期化されていません。 関連する初期化関数を呼び出す必要があります。 |
|
この操作では、ユーザーがサインインする必要があります。 |
注釈
このピアのプレゼンスを監視している連絡先には、このピアのプレゼンス状態の変化を通知するPEER_EVENT_PRESENCE_CHANGED イベントがローカルで発生します。 サインイン中にピアのプレゼンス状態をオフラインに設定することはできません。 既定では、ピアのプレゼンス状態は "オンライン" であり、サインイン時の説明テキストは NULL です。
プレゼンス状態の説明テキストは、255 文字の Unicode 文字に制限されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | p2p.h |
Library | P2P.lib |
[DLL] | P2P.dll |