共用方式為

PeerGroupImportConfig 函式 (p2p.h)

  • 發行項

PeerGroupImportConfig 函式會根據所提供 XML 組態字串中的特定設定，匯入身分識別的對等群組組態。

語法

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

參數

[in] pwzXML

指定 Unicode 字串，其中包含先前使用 PeerGroupExportConfig) 對等群組組態導出 (。 如需字串的特定 XML 格式，請參閱本主題的一節。 此為必要參數。

[in] pwzPassword

指定用來以 Unicode 字串形式存取加密對等群組組態數據的密碼。 此為必要參數。

[in] fOverwrite

如果為 true，則會覆寫現有的群組組態。 如果為 false，則只有在先前的群組組態不存在時，才會寫入群組組態。 預設值為 false。 此為必要參數。

[out] ppwzIdentity

包含匯入完成後傳回的對等識別。 此為必要參數。

[out] ppwzGroup

包含匯入完成後傳回的對等群組對等名稱。 此為必要參數。

傳回值

如果函式成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_ALREADY_EXISTS
 對等群組組態已經存在， 而 fOverwrite 會設定為 false。
 

密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。

備註

若要產生對等群組組態，請呼叫 PeerGroupExportConfig、傳入要導出的身分識別、密碼，以及對等群組的句柄。

組態 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 與 Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll