Funzione PeerCollabInviteContact (p2p.h)
La funzione PeerCollabInviteContact invia un invito a partecipare a un'attività di collaborazione peer a un contatto attendibile. Questa chiamata è sincrona e, in caso di esito positivo, ottiene una risposta dal contatto.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabInviteContact(
[in] PCPEER_CONTACT pcContact,
[in] PCPEER_ENDPOINT pcEndpoint,
[in] PCPEER_INVITATION pcInvitation,
[out] PPEER_INVITATION_RESPONSE *ppResponse
);
Parametri
[in] pcContact
Puntatore a una struttura PEER_CONTACT contenente le informazioni di contatto associate all'invito.
[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.
[in] pcInvitation
Puntatore a una struttura PEER_INVITATION che contiene la richiesta di invito a inviare agli endpoint specificati in pcEndpoint. Questo parametro non deve essere impostato su NULL.
[out] ppResponse
Puntatore a una struttura di PEER_INVITATION_RESPONSE che riceve le risposte di un endpoint peer invitato alla richiesta di invito.
Se la chiamata ha esito negativo con un errore, questo parametro sarà NULL.
Liberare la memoria restituita chiamando 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 garantisce che il peer che riceve l'invito sia il contatto specificato come input. La connessione avrà esito negativo se il contatto specifico non è presente nell'endpoint specificato. L'uso di PeerCollabInviteContact è consigliato al posto di PeerCollabInviteEndpoint meno sicuro.
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 restituito codici di errore perché il destinatario ha disattivato gli inviti dell'applicazione.
Se il destinatario accetta inviti solo da contatti attendibili, il mittente dell'invito deve essere aggiunto all'archivio contatti del computer destinatario. Il mittente deve essere aggiunto all'archivio contatti prima del tentativo di invito. Per aggiungere un contatto all'archivio contatti, chiama PeerCollabAddContact.
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 |