PeerCollabAddContact 関数 (p2p.h)
PeerCollabAddContact 関数は、ピアの連絡先リストに連絡先を追加します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
[in] PCWSTR pwzContactData,
[out, optional] PPEER_CONTACT *ppContact
);
パラメーター
[in] pwzContactData
連絡先リストに追加されたピアの連絡先データを含む、0 で終わる Unicode 文字列バッファーへのポインター。 この文字列バッファーは、 PeerCollabQueryContactData への連絡先として追加するエンドポイントのピア名を渡すか、帯域外メカニズムを介して取得できます。
独自の連絡先データを帯域外で送信するために、ピアは NULL ピア名を使用して PeerCollabExportContact を呼び出すことができます。 この関数は、連絡先データを XML 形式で返します。
[out, optional] ppContact
PEER_CONTACT構造体へのポインターへのポインター。 このパラメーターは、pwzContactData で指定された連絡先のピア連絡先情報を含むPEER_CONTACT構造体のアドレスを受け取ります。 このパラメーターは NULL である可能性があります。
このデータを解放するには、PEER_CONTACT構造体のアドレスで PeerFreeData を呼び出します。
戻り値
関数が成功した場合S_OKを返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
この操作をサポートするのに十分なメモリがありません。 |
|
引数の 1 つが無効です。 |
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |