Funzione PeerGraphAddRecord (p2p.h)

Articolo
03/15/2023

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:

pwzCreatorId : usa l'ID peer passato a PeerGraphCreate o PeerGraphOpen.
pwzModifiedById : usa pwzCreatorId.

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

Condividi tramite