Funzione PeerGraphGetRecord (p2p.h)

La funzione PeerGraphGetRecord recupera un record specifico in base all'ID record specificato. Il record restituito deve essere liberato chiamando PeerGraphFreeData.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetRecord(
  [in]  HGRAPH       hGraph,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parametri

[in] hGraph

Gestire il grafico peer.

[in] pRecordId

Puntatore a registrare l'ID da recuperare.

[out] ppRecord

Riceve il record richiesto. Quando questa struttura non è più necessaria, liberarla chiamando PeerGraphFreeData.

Valore restituito

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

Codice restituito Descrizione
E_INVALIDARG
Uno dei parametri non è valido.
PEER_E_GRAPH_NOT_READY
Il grafico peer non è mai stato sincronizzato. I record non possono essere recuperati fino a quando il grafico peer non è stato sincronizzato.
PEER_E_INVALID_GRAPH
L'handle al grafico peer non è valido.
PEER_E_NOT_INITIALIZED
Il grafico peer deve essere inizializzato con una chiamata a PeerGraphStartup prima di usare questa funzione.
PEER_E_RECORD_NOT_FOUND
Il record specificato non è stato trovato.

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

PeerGraphFreeData