Funzione PeerCollabEnumEndpoints (p2p.h)

Articolo
03/15/2023

La funzione PeerCollabEnumEndpoints restituisce l'handle a un'enumerazione contenente gli endpoint associati a un contatto peer specifico.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
  [in]  PCPEER_CONTACT pcContact,
  [out] HPEERENUM      *phPeerEnum
);

Parametri

[in] pcContact

Puntatore a una struttura PEER_CONTACT che contiene le informazioni di contatto per un peer specifico. Questo parametro non deve essere NULL.

[out] phPeerEnum

Puntatore a un handle per il set enumerato di endpoint associati al contatto peer fornito. Passare questo handle a PeerGetNextItem per ottenere ogni elemento nel set enumerato.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente per supportare questa operazione.
E_INVALIDARG	Uno degli argomenti non è valido.
PEER_E_NOT_INITIALIZED	L'infrastruttura peer di Windows non viene inizializzata. È necessario chiamare la funzione di inizializzazione pertinente.
PEER_E_NOT_SIGNED_IN	L'operazione richiede l'accesso dell'utente.

Commenti

È consigliabile aggiornare un record di contatto usando PeerCollabUpdateContact prima di chiamare PeerCollabEnumEndpoints. In caso contrario, è possibile restituire E_INVALIDARG.

Gli endpoint saranno disponibili solo per i contatti con fWatch impostato su true. Solo gli endpoint che hanno il contatto "Me" del peer chiamante salvato come contatto attendibile e hanno WatcherPermissions impostato per consentire saranno disponibili. Un contatto deve anche essere connesso a Internet. Se il contatto non è connesso, verrà restituito l'errore E_INVALIDARG .

Per ottenere i singoli endpoint peer, passare l'handle restituito a PeerGetNextItem. Verrà restituita una matrice di puntatori a PEER_ENDPOINT strutture. Se non sono disponibili endpoint, verrà restituita una matrice vuota. Per chiudere l'enumerazione e rilasciare le risorse associate, passare questo handle a PeerEndEnumeration. I singoli elementi restituiti dall'enumerazione devono essere rilasciati con PeerFreeData.

Il limite per le connessioni a un singolo contatto è 50.

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

Vedi anche

PEER_ENDPOINT

Funzioni API di collaborazione peer

Condividi tramite