Funzione PeerGraphEnumRecords (p2p.h)

Articolo
08/25/2023

La funzione PeerGraphEnumRecords crea e restituisce un handle di enumerazione utilizzato per enumerare record di un tipo specifico di record, utente o entrambi. Un'enumerazione fornisce uno snapshot dei record al momento dell'esecuzione di un'enumerazione.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
  [in]  HGRAPH     hGraph,
  [in]  const GUID *pRecordType,
  [in]  PCWSTR     pwzPeerId,
  [out] HPEERENUM  *phPeerEnum
);

Parametri

[in] hGraph

Gestire in un grafo peer.

[in] pRecordType

Puntatore al tipo di record da enumerare. Specificare NULL per enumerare tutti i tipi di record.

[in] pwzPeerId

Puntatore a una stringa che identifica l'autore per cui un'applicazione richiede un'enumerazione. Specificare NULL per enumerare tutti i record.

[out] phPeerEnum

Riceve un handle per un'enumerazione. Fornire l'handle a tutte le chiamate a PeerGraphGetNextItem. Quando non è necessario un handle, liberarlo chiamando PeerGraphEndEnumeration.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito viene S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Un parametro non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_INVALID_GRAPH	L'handle di un grafo peer non è valido.
PEER_E_NOT_INITIALIZED	È necessario inizializzare un grafico con una chiamata a PeerGraphStartup prima di usare questa funzione.

Commenti

Se i parametri pRecordType e pwzPeerId sono NULL, vengono restituiti tutti i record.

Per semplici attività di enumerazione, usare la funzione PeerGraphEnumRecords , perché è più efficiente rispetto alla funzione PeerGraphSearchRecords . Per attività complesse di enumerazione e filtro, ad esempio ricerche euristiche del database, usare la funzione PeerGraphSearchRecords .

Quando PeerGraphGetNextItem viene chiamato con l'handle restituito da PeerGraphEnumRecords , PeerGraphGetNextItem restituisce i dati nella struttura PEER_RECORD .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2PGraph.lib
DLL	P2PGraph.dll

Vedi anche

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords

Condividi tramite