Funzione PeerCollabInviteEndpoint (p2p.h)
La funzione PeerCollabInviteEndpoint invia un invito a un endpoint peer specificato per aggiungere l'attività di collaborazione peer del mittente. Questa chiamata è sincrona e, se ha esito positivo, ottiene una risposta dall'endpoint peer.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabInviteEndpoint(
[in] PCPEER_ENDPOINT pcEndpoint,
[in] PCPEER_INVITATION pcInvitation,
[out] PPEER_INVITATION_RESPONSE *ppResponse
);
Parametri
[in] pcEndpoint
Puntatore a una struttura PEER_ENDPOINT che contiene informazioni sul peer invitato. Questo peer viene inviato un invito quando questa API viene chiamata.
Questo parametro non deve essere impostato su NULL.
[in] pcInvitation
Puntatore a una struttura PEER_INVITATION che contiene la richiesta di invito a inviare all'endpoint specificato in pcEndpoint. Questo parametro non deve essere impostato su NULL.
[out] ppResponse
Puntatore a una struttura PEER_INVITATION_RESPONSE che riceve le risposte di un endpoint peer invitato alla richiesta di invito.
Se questa chiamata ha esito negativo con un errore, nell'output questo parametro sarà NULL.
Liberare la memoria associata a questa struttura passandola a PeerFreeData.
Valore restituito
Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Memoria insufficiente per supportare questa operazione. |
|
Uno degli argomenti non è valido. |
|
Il destinatario dell'invito non ha risposto entro 5 minuti. |
Commenti
Questa API invia un invito all'endpoint specificato come input. Non garantisce che il destinatario dell'invito sia il contatto specifico a cui l'utente intende inviare l'invito. Per assicurarsi che l'invito venga inviato al contatto corretto, chiamare PeerCollabInviteContact.
Verrà visualizzato un avviso popup per il destinatario dell'invito. Questo avviso popup verrà convertito in una finestra di dialogo in cui l'utente può accettare o rifiutare l'invito. Quando l'invito viene accettato correttamente, l'applicazione collaborativa viene avviata nel computer del destinatario.
Per ricevere correttamente l'invito, l'applicazione deve essere registrata nel computer del destinatario usando PeerCollabRegisterApplication. È anche possibile che il mittente dell'invito abbia codici di errore restituiti perché il destinatario ha disattivato gli inviti dell'applicazione.
Il destinatario dell'invito deve rispondere entro 5 minuti per evitare il timeout.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | p2p.h |
| Libreria | P2P.lib |
| DLL | P2P.dll |