PeerGraphDeleteRecord-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGraphDeleteRecord-Funktion kennzeichnet einen Datensatz als gelöscht in einem Peerdiagramm. Der Datensatz ist auf einem lokalen Knoten nicht für Funktionsaufrufe verfügbar, z. B. Aufrufe von PeerGraphGetRecord und PeerGraphEnumRecords.

Syntax

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

Parameter

[in] hGraph

Handle mit einem Peerdiagramm.

[in] pRecordId

Zeiger auf eine zu löschende Datensatz-ID.

[in] fLocal

Geben Sie TRUE an, um einen Datensatz nur aus einer lokalen Datenbank zu entfernen, ohne den Rest eines Peerdiagramms über die Änderung zu benachrichtigen. Geben Sie FALSE an, um den Datensatz aus einem gesamten Peerdiagramm zu löschen.

Hinweis Die Angabe von TRUE verhindert nicht, dass ein Datensatz bei der nächsten Graphsynchronisierung mit einem Nachbarn erneut hinzugefügt wird. Die Angabe von TRUE ist nur wirksam, wenn PEER_SECURITY_INTERFACE in einem Aufruf von PeerGraphOpen oder PeerGraphCreate angegeben wird, und nur dann, wenn PEER_SECURITY_INTERFACE eine PFNPEER_VALIDATE_RECORD-Funktion enthält, die beim Überprüfen des Datensatzes PEER_E_INVALID_RECORD zurückgibt.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
E_ACCESSDENIED	Auf ein Peerdiagramm kann nicht zugegriffen werden.
PEER_E_GRAPH_NOT_READY	Das Peerdiagramm wird nicht synchronisiert. Datensätze können erst gelöscht werden, wenn das Diagramm synchronisiert ist.
PEER_E_INVALID_GRAPH	Das Handle für ein Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.
PEER_E_RECORD_NOT_FOUND	Der angegebene Datensatz wurde nicht gefunden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2PGraph.lib
DLL	P2PGraph.dll

Weitere Informationen

PeerGraphAddRecord

PeerGraphEnumRecords

PeerGraphGetRecord

PeerGraphUpdateRecord