共用方式為


PeerCollabGetApplicationRegistrationInfo 函式 (p2p.h)

PeerCollabGetApplicationRegistrationInfo 函式會取得應用程式特定的註冊資訊。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetApplicationRegistrationInfo(
  [in]  const GUID                          *pApplicationId,
  [in]  PEER_APPLICATION_REGISTRATION_TYPE  registrationType,
  [out] PPEER_APPLICATION_REGISTRATION_INFO *ppApplication
);

參數

[in] pApplicationId

GUID 值的指標,表示特定對等的應用程式註冊旗標。

[in] registrationType

PEER_APPLICATION_REGISTRATION_TYPE列舉值,描述對等的應用程式是否已向目前使用者或本機計算機的所有用戶註冊。

[out] ppApplication

包含對等特定註冊應用程式相關信息之 PEER_APPLICATION_REGISTRATION_INFO 結構的位址指標。 呼叫 PeerFreeData,即可釋放此參數中傳回的數據。

傳回值

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

傳回碼 Description
E_OUTOFMEMORY
記憶體不足,無法支援此作業。
E_INVALIDARG
其中一個自變數無效。
PEER_E_NOT_FOUND
要求的應用程式未針對指定的 registrationType 註冊。

備註

應用程式是一組可在對等端點上使用的軟體或軟體功能。 通常,這是指支援對等網路活動的軟體套件,例如遊戲或其他共同作業應用程式。

對等的應用程式具有代表單一應用程式的 GUID。 註冊對等的應用程式時,此 GUID 和對應的應用程式可以提供給對等的所有受信任聯繫人使用,指出對等可以參與的活動。 若要取消註冊對等的應用程式,請使用這個 GUID 呼叫 PeerCollabUnregisterApplication

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll

另請參閱

PEER_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

對等共同作業 API 函式

PeerCollabRegisterApplication

PeerCollabUnregisterApplication