共用方式為

peerGroupExportConfig 函式 (p2p.h)

  • 發行項

PeerGroupExportConfig 函式會將對等的群組組態匯出為包含身分識別、組名和 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

傳回之 XML 組態字串的指標，其中包含身分識別、群組對等名稱、雲端對等名稱、群組範圍，以及身分識別的 GMC。 此為必要參數。

傳回值

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

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_NO_KEY_ACCESS
 拒絕存取身分識別或群組金鑰。 一般而言，這是因為包含使用者或計算機密鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 手動重設時，就會發生這種情況。
 

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

備註

導出之後，可以將此組態從頻外傳遞至另一個對等，其中可以建立身分識別的組態。 若要匯入組態，請將此函式傳回的 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 與 Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll