peerCollabRegisterApplication 函式 (p2p.h)
PeerCollabRegisterApplication 函式會向本機計算機註冊應用程式，以便在對等共同作業活動中啟動。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
[in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
[in] PEER_APPLICATION_REGISTRATION_TYPE registrationType
);
參數
[in] pcApplication
包含對等應用程式功能集之 UUID 以及任何其他對等特定資料的 PEER_APPLICATION_REGISTRATION_INFO 結構的指標。
[in] registrationType
PEER_APPLICATION_REGISTRATION_TYPE值，描述對等應用程式是否已向目前使用者或對等計算機的所有用戶註冊。
傳回值
如果函式成功，則傳回S_OK。 否則，函式會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
記憶體不足，無法支援這項作業。 |
|
其中一個自變數無效。 |
備註
應用程式是一組軟體或軟體功能，可在對等的端點上使用。 通常，這是指支援對等網路活動的軟體套件，例如遊戲或其他共同作業應用程式。
共同作業基礎結構可以接收來自受信任聯繫人的應用程式邀請，或從「人員 Near Me」接收，此邀請是以共同作業基礎結構使用 PeerCollabSignin 登入的範圍為基礎。
對等的應用程式具有代表單一特定應用程式的 GUID。 為對等註冊應用程式時，這個 GUID 和對應的應用程式可以提供給對等的所有受信任聯繫人使用，表示對等可以參與的活動。 若要取消註冊對等的應用程式，請使用這個 GUID 呼叫 PeerCollabUnregisterApplication 。
註冊應用程式時，建議開發人員指定相對路徑，例如 %ProgramFiles%，而不是絕對路徑。 這可防止應用程式失敗，因為應用程式檔的位置有所變更。 例如，如果 C：\ProgramFiles 目錄移至 E：\。
只有本機計算機的應用程式可以註冊。 當應用程式的可執行檔路徑位於 UNC 路徑或本機對應網路驅動器機等網路共用時，就無法註冊。
應用程式可以在 『ALL_USERS』 和 『CURRENT_USER』 範圍中註冊。 如果同時在兩個範圍中註冊應用程式，在 『CURRENT_USER』 範圍中註冊的應用程式會優先於 『ALL_USERS』 範圍中註冊的應用程式。 請務必注意，若要註冊 『ALL_USERS』 註冊類型，呼叫端必須以系統管理許可權運作。
可針對特定 registrationType 註冊的應用程式數目上限為 64。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |