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 |
---|---|
|
必須先啟動 對等名稱解析通訊協定 (PNRP) 服務,才能呼叫 PeerGroupStartup。 |
|
記憶體不足,無法完成作業。 |
|
群組服務無法啟動,因為計算機上未安裝IPv6。 |
|
已安裝的對等子系統不支援要求的版本。 |
密碼編譯特定錯誤可以從 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 |