PeerGroupDeleteRecord-Funktion (p2p.h)

Artikel
03/04/2024

Die Funktion PeerGroupDeleteRecord löscht einen Datensatz aus einer Peergruppe. Der Ersteller sowie jedes andere Mitglied in einer Administratorrolle können einen bestimmten Datensatz löschen.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDeleteRecord(
  [in] HGROUP     hGroup,
  [in] const GUID *pRecordId
);

Parameter

[in] hGroup

Handle mit der Peergruppe, die den Datensatz enthält. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pRecordId

Gibt den GUID-Wert an, der den zu löschenden Datensatz eindeutig identifiziert. Dieser Parameter ist erforderlich.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
PEER_E_GROUP_NOT_READY	Die Peergruppe befindet sich nicht in einem Zustand, in dem Datensätze gelöscht werden können. Beispielsweise wird PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank wurde nicht abgeschlossen.
PEER_E_INVALID_GROUP	Das Handle für die Peergruppe ist ungültig.
PEER_E_NOT_AUTHORIZED	Die aktuelle Identität verfügt nicht über die Berechtigung zum Löschen des Datensatzes. In diesem Fall ist die Identität nicht der Ersteller, oder ein Mitglied in einer Administratorrolle kann einen bestimmten Datensatz löschen.
PEER_E_RECORD_NOT_FOUND	Der Datensatz kann nicht im Datenspeicher gefunden werden.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

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	P2P.lib
DLL	P2P.dll

Weitere Informationen

PeerGroupUpdateRecord