Funzione PeerGraphDeleteRecord (p2p.h)

Articolo
03/01/2024

La funzione PeerGraphDeleteRecord contrassegna un record come eliminato all'interno di un grafo peer. Il record non è disponibile in un nodo locale per le chiamate di funzione, ad esempio le chiamate a PeerGraphGetRecord e PeerGraphEnumRecords.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphDeleteRecord(
  [in] HGRAPH     hGraph,
  [in] const GUID *pRecordId,
  [in] BOOL       fLocal
);

Parametri

[in] hGraph

Gestire in un grafo peer.

[in] pRecordId

Puntatore a un ID record da eliminare.

[in] fLocal

Specificare TRUE per rimuovere un record solo da un database locale senza notificare al resto di un grafico peer la modifica. Specificare FALSE per eliminare il record da un intero grafico peer.

Nota Se si specifica TRUE , non si impedisce l'aggiunta di nuovo di un record durante la successiva sincronizzazione del grafo con un oggetto adiacente. La specifica di TRUE è valida solo se PEER_SECURITY_INTERFACE viene specificato in una chiamata a PeerGraphOpen o PeerGraphCreate e solo se PEER_SECURITY_INTERFACE contiene una funzione PFNPEER_VALIDATE_RECORD che restituisce PEER_E_INVALID_RECORD durante la convalida del record.

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_ACCESSDENIED	Impossibile accedere a un grafo peer.
PEER_E_GRAPH_NOT_READY	Il grafico peer non è sincronizzato. I record non possono essere eliminati finché il grafico non viene sincronizzato.
PEER_E_INVALID_GRAPH	L'handle di un grafo peer non è valido.
PEER_E_NOT_INITIALIZED	Il grafo peer deve essere inizializzato con una chiamata a PeerGraphStartup prima di usare questa funzione.
PEER_E_RECORD_NOT_FOUND	Impossibile trovare il record specificato.

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

PeerGraphAddRecord

PeerGraphEnumRecords

PeerGraphGetRecord

PeerGraphUpdateRecord