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 |
---|---|
|
記憶體不足,無法支援這項作業。 |
|
其中一個自變數無效。 |
|
邀請的收件者未在5分鐘內回應。 |
備註
此 API 會將邀請傳送至指定為輸入的端點。 不保證邀請的收件者是用戶要傳送邀請的特定聯繫人。 若要確保邀請已傳送至正確的聯繫人,請呼叫 PeerCollabInviteContact。
邀請收件者會出現快顯通知。 此快顯通知會轉換成對話框,讓使用者可以接受或拒絕邀請。 成功接受邀請時,會在收件者的計算機上啟動共同作業應用程式。
若要成功收到邀請,您必須使用 PeerCollabRegisterApplication 在收件者的電腦上註冊應用程式。 邀請的寄件者也可能傳回失敗碼,因為收件者已關閉應用程式邀請。
邀請的收件者必須在5分鐘內回應,以避免逾時。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | p2p.h |
程式庫 | P2P.lib |
Dll | P2P.dll |