Freigeben über


PeerGroupDeleteRecord-Funktion (p2p.h)

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

PeerGroupAddRecord

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupUpdateRecord