次の方法で共有

PeerGroupImportConfig 関数 (p2p.h)

  • [アーティクル]

PeerGroupImportConfig 関数は、指定された XML 構成文字列の特定の設定に基づいて、ID のピア グループ構成をインポートします。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupImportConfig(
  [in]  PCWSTR pwzXML,
  [in]  PCWSTR pwzPassword,
  [in]  BOOL   fOverwrite,
  [out] PWSTR  *ppwzIdentity,
  [out] PWSTR  *ppwzGroup
);

パラメーター

[in] pwzXML

以前にエクスポートされた ( PeerGroupExportConfig を使用して) ピア グループ構成を含む Unicode 文字列を指定します。 文字列の特定の XML 形式については、このトピックの「解説」セクションを参照してください。 このパラメーターは必須です。

[in] pwzPassword

暗号化されたピア グループ構成データへのアクセスに使用されるパスワードを Unicode 文字列として指定します。 このパラメーターは必須です。

[in] fOverwrite

true の場合、既存のグループ構成が上書きされます。 false の場合、グループ構成は、以前のグループ構成が存在しない場合にのみ書き込まれます。 既定値は false です。 このパラメーターは必須です。

[out] ppwzIdentity

インポートの完了後に返されるピア ID を格納します。 このパラメーターは必須です。

[out] ppwzGroup

インポートが完了した後に返されるピア グループ ピア名が含まれます。 このパラメーターは必須です。

戻り値

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

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_ALREADY_EXISTS
 ピア グループの構成は既に存在し、 fOverwrite は false に設定されています。
 

暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

注釈

ピア グループ構成を生成するには、 PeerGroupExportConfig を呼び出し、エクスポートする ID、パスワード、およびピア グループへのハンドルを渡します。

構成 XML 文字列は次の形式で表示されます。

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the peer group -->
  </GROUPPEERNAME>
  <CLOUDNAME>
    <!-- UTF-8 encoded Unicode name of the cloud -->
  </CLOUDNAME>
  <SCOPE>
    <!-- UTF-8 encoded Unicode name of the scope: global, site-local, link-local -->
  </SCOPE>
  <CLOUDFLAGS>
    <!-- A DWORD that contains cloud-specific settings, represented as a string -->
  </CLOUDFLAGS>
  <GMC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
    <!-- base64/PKCS7 encoded GMC chain -->
  </GMC>
</PEERGROUPCONFIG>

要件

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