PeerCollabGetContact 関数 (p2p.h)

PeerCollabGetContact 関数は、連絡先のピア名を指定してピア連絡先の情報を取得します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
  [in, optional]  PCWSTR        pwzPeerName,
  [out, optional] PPEER_CONTACT *ppContact
);

[in, optional] pwzPeerName

情報を取得するピア連絡先の名前を含む、0 で終わる Unicode 文字列へのポインター。

このパラメーターが NULL の場合、呼び出し元ピアの 'Me' 連絡先情報が返されます。

[out, optional] ppContact

PEER_CONTACT構造体へのポインターへのポインター。 pwzPeerName で指定されたピア名のピア連絡先情報を含むPEER_CONTACT構造体のアドレスを受け取ります。このパラメーターが NULL の場合、この関数は E_INVALIDARGを返します。

このデータを解放するには、PEER_CONTACT構造体のアドレスで PeerFreeData を呼び出します。

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

リターンコード	説明
E_OUTOFMEMORY	この操作をサポートするのに十分なメモリがありません。
E_INVALIDARG	引数の 1 つが無効です。
PEER_E_NOT_INITIALIZED	Windows ピアインフラストラクチャが初期化されていません。関連する初期化関数を呼び出す必要があります。