PeerCollabEnumApplicationRegistrationInfo 函式 (p2p.h)
PeerCollabEnumApplicationRegistrationInfo 函式會取得用來擷取對等應用程式資訊的列舉句柄。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
[in] PEER_APPLICATION_REGISTRATION_TYPE registrationType,
[out] HPEERENUM *phPeerEnum
);
參數
[in] registrationType
PEER_APPLICATION_REGISTRATION_TYPE值，指定對等應用程式是否已向目前使用者或對等計算機的所有用戶註冊。
[out] phPeerEnum
對等應用程式註冊資訊的對等列舉句柄指標。 此數據是透過將此句柄傳遞至 PeerGetNextItem 來取得。
傳回值
如果函式成功，則傳回S_OK。 否則，函式會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
記憶體不足，無法支援這項作業。 |
|
其中一個自變數無效。 |
|
Windows 對等基礎結構未初始化。 需要呼叫相關的初始化函式。 |
備註
若要取得個別對等應用程式，請將傳回的句柄傳遞至 PeerGetNextItem。 將會傳回 PEER_APPLICATION_REGISTRATION_INFO 結構的陣列。 若要關閉列舉並釋放與其相關聯的資源，請將此句柄傳遞至 PeerEndEnumeration。 列舉傳回的個別項目必須使用 PeerFreeData 釋放。
應用程式是一組軟體或軟體功能，可在對等的端點上使用。 通常，這是指支援對等網路活動的軟體套件，例如遊戲或其他共同作業應用程式。
對等的應用程式具有代表單一特定應用程式的 GUID。 為對等註冊應用程式時，這個 GUID 和對應的應用程式可以提供給對等的所有受信任聯繫人使用，表示對等可以參與的活動。 若要取消註冊對等的應用程式，請使用這個 GUID 呼叫 PeerCollabUnregisterApplication 。
對等應用程式註冊信息專案會以個別 PEER_APPLICATION_REGISTRATION_INFO 結構傳回。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |
另請參閱
PEER_APPLICATION_REGISTRATION_INFO