Share via

PeerGroupExportConfig 関数 (p2p.h)

  • [アーティクル]

PeerGroupExportConfig 関数は、ピアのグループ構成を、ID、グループ名、および ID の GMC を含む XML 文字列としてエクスポートします。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupExportConfig(
  [in]  HGROUP hGroup,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzXML
);

パラメーター

[in] hGroup

グループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。 このパラメーターは必須です。

[in] pwzPassword

エクスポートされた構成を保護するために使用するパスワードを指定します。 このパスワードの作成に関する規則や制限はありません。 このパラメーターは必須です。

[out] ppwzXML

ID、グループ ピア名、クラウド ピア名、グループ スコープ、および ID の GMC を含む、返される XML 構成文字列へのポインター。 このパラメーターは必須です。

戻り値

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

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

暗号化固有のエラーは、 Microsoft Base Cryptographic Provider から返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

注釈

エクスポート後、この構成を帯域外で別のピアに渡すことができます。ここで、ID の構成を確立できます。 構成をインポートするには、この関数によって返される XML 文字列を、パスワードを PeerGroupImportConfig に設定して渡します。

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

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the 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 containing 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