次の方法で共有

PeerCollabQueryContactData 関数 (p2p.h)

  • [アーティクル]

PeerCollabQueryContactData 関数は、指定されたピア エンドポイントの連絡先情報を取得します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [out]          PWSTR           *ppwzContactData
);

パラメーター

[in, optional] pcEndpoint

連絡先情報を取得するピア エンドポイントを含む PEER_ENDPOINT 構造体へのポインター。

このパラメーターが NULL に設定されている場合は、現在のピア エンドポイントの連絡先情報が取得されます。

[out] ppwzContactData

pcEndpoint で指定されたエンドポイントの連絡先データを含む、0 で終わる Unicode 文字列バッファーへのポインター。 PeerFreeData を呼び出してデータを解放します。

戻り値

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

リターン コード 説明
E_OUTOFMEMORY
 この操作をサポートするのに十分なメモリがありません。
E_INVALIDARG
 引数の 1 つが無効です。
PEER_E_NOT_FOUND
 要求された連絡先データが存在しません。 別の試行を行う前に 、PeerCollabRefreshEndpointData を呼び出してみてください。

注釈

エンドポイントの連絡先データを正常に取得するには、次のいずれかが発生する必要があります。

  • エンドポイントは、 PeerCollabEnumEndpoints を呼び出すことによって以前に取得されている必要があります。
  • ローカル ピアは、 PeerCollabSubscribeEndpointData を呼び出してエンドポイントをサブスクライブしている必要があります。
  • エンドポイント データは、 PeerCollabRefreshEndpointData を正常に呼び出して更新する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2P.lib
[DLL] P2P.dll

こちらもご覧ください

PEER_ENDPOINT

ピア コラボレーション API 関数