次の方法で共有

PeerIdentityExport 関数 (p2p.h)

  • [アーティクル]

PeerIdentityExport 関数を使用すると、ユーザーは 1 つのピア ID をエクスポートできます。 その後、ユーザーはピア ID を別のコンピューターに転送できます。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityExport(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzExportXML
);

パラメーター

[in] pwzIdentity

エクスポートするピア ID を指定します。 このパラメーターは必須であり、既定値はありません。

[in] pwzPassword

ピア ID の暗号化に使用するパスワードを指定します。 このパラメーターを NULL にすることはできません。 このパスワードは、ピア ID のインポートにも使用する必要があります。または、インポート操作が失敗します。

[out] ppwzExportXML

エクスポートされたピア ID へのポインターを XML 形式で受け取ります。 エクスポート操作が成功した場合、アプリケーションは PeerFreeData を呼び出して ppwzExportXML を解放する必要があります。

戻り値

関数呼び出しが成功した場合、戻り値は S_OK。 それ以外の場合は、次のいずれかの値が返されます。

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_NO_KEY_ACCESS
 ピア ID またはピア グループ キーへのアクセスが拒否されました。 これは通常、ユーザーまたはコンピューター キーを含むフォルダーに対して正しくないアクセス制御リスト (ACL) が原因で発生します。 これは、ACL が手動でリセットされた場合に発生する可能性があります。
PEER_E_NOT_FOUND
指定されたピア ID が存在しません。

注釈

ピア ツー ピア グループ メンバーシップの資格情報はエクスポートされません。 エクスポートされるピア ID は 1 つだけです。 エクスポートされたピア ID は、 PeerIdentityImport を使用して別のコンピューターにインポートできます。

ピア ID をエクスポートしても、ローカル ccmputer からピア ID は削除されず、コピーが作成されます。 コピーを使用して、ピア ID をバックアップおよび復元できます。

PeerIdentityExport で使用される XML フラグメントは次のとおりです。

<PEERIDENTITYEXPORT VERSION="1.0">
   <PEERNAME>
     <!-- UTF-8 encoded peer name of the identity -->
   </PEERNAME>
   <DATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </DATA>
</PEERIDENTITYEXPORT>

要件

要件 値
サポートされている最小のクライアント Windows XP と SP2 [デスクトップ アプリのみ]、Windows XP 用 Advanced Networking Pack を使用した SP1 の Windows XP
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2P.lib
[DLL] P2P.dll

こちらもご覧ください

PEER_DATA

PeerFreeData

PeerIdentityImport