共用方式為


PeerCollabInviteEndpoint 函式 (p2p.h)

PeerCollabInviteEndpoint 函式會將邀請傳送至指定的對等端點,以加入傳送者的對等共同作業活動。 此呼叫是同步的,如果成功,就會從對等端點取得回應。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabInviteEndpoint(
  [in]  PCPEER_ENDPOINT           pcEndpoint,
  [in]  PCPEER_INVITATION         pcInvitation,
  [out] PPEER_INVITATION_RESPONSE *ppResponse
);

參數

[in] pcEndpoint

包含受邀對等資訊 之PEER_ENDPOINT 結構的指標。 呼叫此 API 時,此對等會傳送邀請。

此參數不得設定為 NULL

[in] pcInvitation

PEER_INVITATION 結構的指標,其中包含要傳送至pcEndpoint中所指定端點的邀請要求。 此參數不得設定為 NULL

[out] ppResponse

PEER_INVITATION_RESPONSE結構的指標,該結構會接收邀請要求的受邀對等端點回應。

如果此呼叫失敗併發生錯誤,則此參數在輸出時會是 NULL

將它傳遞至 PeerFreeData,以釋放與此結構相關聯的記憶體。

傳回值

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

傳回碼 Description
E_OUTOFMEMORY
記憶體不足,無法支援這項作業。
E_INVALIDARG
其中一個自變數無效。
PEER_E_TIMEOUT
邀請的收件者未在5分鐘內回應。

備註

此 API 會將邀請傳送至指定為輸入的端點。 不保證邀請的收件者是用戶要傳送邀請的特定聯繫人。 若要確保邀請已傳送至正確的聯繫人,請呼叫 PeerCollabInviteContact

邀請收件者會出現快顯通知。 此快顯通知會轉換成對話框,讓使用者可以接受或拒絕邀請。 成功接受邀請時,會在收件者的計算機上啟動共同作業應用程式。

若要成功收到邀請,您必須使用 PeerCollabRegisterApplication 在收件者的電腦上註冊應用程式。 邀請的寄件者也可能傳回失敗碼,因為收件者已關閉應用程式邀請。

邀請的收件者必須在5分鐘內回應,以避免逾時。

規格需求

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

另請參閱

PEER_ENDPOINT

PEER_INVITATION

PEER_INVITATION_RESPONSE

對等共同作業 API 函式

PeerCollabGetAppLaunchInfo