共用方式為


peerGroupStartup 函式 (p2p.h)

PeerGroupStartup 函式會使用要求的對等基礎結構版本來起始對等群組。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

參數

[in] wVersionRequested

指定呼叫端可支援的最高對等基礎結構版本。 高序位元組會指定次要版本 (修訂) 編號。 低順序位元組指定主要版本號碼 此參數是必要的。

[out] pVersionData

包含對等基礎結構所提供之特定支持層級 之PEER_VERSION_DATA 結構的指標。 此為必要參數。

傳回值

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

傳回碼 Description
ERROR_SERVICE_DEPENDENCY_FAIL
必須先啟動 對等名稱解析通訊協定 (PNRP) 服務,才能呼叫 PeerGroupStartup
E_OUTOFMEMORY
記憶體不足,無法完成作業。
PEER_E_IPV6_NOT_INSTALLED
群組服務無法啟動,因為計算機上未安裝IPv6。
PEER_E_UNSUPPORTED_VERSION
已安裝的對等子系統不支援要求的版本。
 

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

備註

必須先啟動 對等名稱解析通訊協定 (PNRP) 服務,才能呼叫此函式。

呼叫任何其他對等群組函式之前,應用程式會先呼叫此函式。

在此版本中,應用程式應該使用 PEER_GROUP_VERSION 作為要求的版本。

當應用程式終止時,呼叫 PeerGroupShutdown 會關閉以這個函式啟動的對等群組。

規格需求

需求
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式],Windows XP 含 SP1 與 Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll

另請參閱

群組 API 函式

PEER_VERSION_DATA

PeerGroupShutdown