peerCollabEnumApplications 函式 (p2p.h)
PeerCollabEnumApplications函式會傳回列舉的控制碼，其中包含註冊到特定對等端點的應用程式 () 。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pApplicationId,
[out] HPEERENUM *phPeerEnum
);
參數
[in, optional] pcEndpoint
PEER_ENDPOINT結構的指標，其中包含將列舉應用程式之對等的端點資訊。
如果此參數設定為 Null，則會列舉本機對等端點的已發佈應用程式資訊。
[in, optional] pApplicationId
GUID 值的指標，可唯一識別所提供對等的特定應用程式。 如果提供此參數，傳回的唯一對等應用程式就是符合此 GUID 的對等應用程式。
[out] phPeerEnum
對應至 pObjectId中傳回之 GUID 之列舉集之登錄應用程式的控制碼指標。 將此控制碼傳遞至 PeerGetNextItem ，以取得列舉集中的每個專案。
傳回值
如果函式成功，則傳回S_OK。 否則，函式會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
記憶體不足，無法支援這項作業。 |
|
其中一個引數無效。 |
|
Windows 對等基礎結構未初始化。 需要呼叫相關的初始化函式。 |
備註
若要成功列舉指定端點的應用程式，必須在端點上使用應用程式資料。 若要讓應用程式資料可供使用，必須發生下列其中一項：
- 先前必須藉由呼叫 PeerCollabEnumEndpoints來取得端點。
- 本機對等必須藉由呼叫 PeerCollabSubscribeEndpointData來訂閱端點。
- 端點資料必須藉由成功呼叫 PeerCollabRefreshEndpointData 來重新整理。
若要取得個別對等應用程式，請將傳回的控制碼傳遞至 PeerGetNextItem。 若要關閉列舉並釋放與其相關聯的資源，請將此控制碼傳遞至 PeerEndEnumeration。 列舉傳回的個別專案必須使用 PeerFreeData釋放。
對等應用程式資料項目會以個別 PEER_APPLICATION 結構傳回。
PeerCollabEnumApplications函式會針對子網上不受信任連絡人的端點傳回空陣列。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |