Funzione PeerCollabQueryContactData (p2p.h)
La funzione PeerCollabQueryContactData recupera le informazioni di contatto per l'endpoint peer fornito.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[out] PWSTR *ppwzContactData
);
Parametri
[in, optional] pcEndpoint
Puntatore a una struttura PEER_ENDPOINT contenente l'endpoint peer su cui ottenere le informazioni di contatto.
Se questo parametro è impostato su NULL, vengono ottenute le informazioni di contatto per l'endpoint peer corrente.
[out] ppwzContactData
Puntatore a un buffer di stringa Unicode con terminazione zero contenente i dati di contatto per l'endpoint fornito in pcEndpoint. Chiamare PeerFreeData per liberare i dati.
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. |
|
I dati di contatto richiesti non esistono. Provare a chiamare PeerCollabRefreshEndpointData prima di eseguire un altro tentativo. |
Commenti
Per recuperare i dati di contatto per un endpoint correttamente, è necessario che si verifichi uno dei seguenti elementi:
- L'endpoint deve essere stato ottenuto in precedenza chiamando PeerCollabEnumEndpoints.
- Il peer locale deve avere sottoscritto l'endpoint chiamando PeerCollabSubscribeEndpointData.
- I dati dell'endpoint devono essere aggiornati chiamando PeerCollabRefreshEndpointData correttamente.
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 |