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 |
|---|---|
|
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. |
|
Das Handle für die Peergruppe ist ungültig. |
|
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. |
|
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 |