Funzione PeerGraphAddRecord (p2p.h)

  • Articolo

La funzione PeerGraphAddRecord aggiunge un nuovo record a un grafico peer. Un record aggiunto con questa funzione viene inviato a ogni nodo in un grafico peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parametri

[in] hGraph

Gestire un grafico peer.

[in] pRecord

Puntatore a un record da aggiungere.

[out] pRecordId

Specifica l'ID record che identifica in modo univoco un record in un grafico peer.

Valore restituito

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

Codice restituito Descrizione
E_ACCESSDENIED
 Impossibile accedere a un grafico peer.
E_INVALIDARG
 Uno dei parametri non è valido.
E_OUTOFMEMORY
 Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_GRAPH_NOT_READY
 Un grafico non è sincronizzato. I record non possono essere aggiunti fino a quando il grafico peer non viene sincronizzato.
PEER_E_GRAPH_SHUTTING_DOWN

PeerGraphClose è stato chiamato.
PEER_E_INVALID_ATTRIBUTES
 Gli attributi specificati non corrispondono allo schema.
PEER_E_INVALID_GRAPH
 L'handle a un grafico peer non è valido.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 Il record supera le dimensioni massime consentite da un grafico peer.
PEER_E_NOT_INITIALIZED
 Il grafico deve essere inizializzato con una chiamata a PeerGraphStartup, prima di usare questa funzione.

Commenti

I membri seguenti della struttura PEER_RECORD devono contenere valori validi:

  • dwSize.
  • tipo.
  • ftExpiration : deve essere successiva all'ora del grafico corrente e deve essere specificata in tempo peer usando PeerGraphUniversalTimeToPeerTime.
I membri seguenti della struttura PEER_RECORD sono facoltativi. Impostarli su NULL se non vengono usati dall'applicazione:
  • data
  • pwzAttributes
  • securityData
  • dwVersion
Se uno dei membri seguenti è NULL, l'API Peer Graphing esegue il comportamento predefinito specificato: Non è possibile specificare i membri seguenti; qualsiasi valore usato viene sovrascritto dall'infrastruttura Peer Graphing:
  • id.
  • ftCreation : usa il tempo peer.
  • ftLastModified : usa il tempo di peer.

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

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate