PeerGroupDelete-Funktion (p2p.h)

Artikel
03/04/2024

Die Funktion PeerGroupDelete löscht die lokalen Daten und das Zertifikat, die einer Peergruppe zugeordnet sind.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzGroupPeerName
);

Parameter

[in] pwzIdentity

Zeiger auf eine Unicode-Zeichenfolge, die die Identität enthält, die die angegebene Peergruppe öffnet. Wenn dieser Parameter NULL ist, verwendet die Implementierung die Identität, die von PeerIdentityGetDefault abgerufen wurde.

[in] pwzGroupPeerName

Zeiger auf eine Unicode-Zeichenfolge, die den Peernamen der Peergruppe enthält, für die Daten gelöscht werden. Dieser Parameter ist erforderlich. Der Gruppenname kann abgerufen werden, indem Sie PeerGroupGetProperties vor PeerGroupClose aufrufen oder die Einladung mit PeerGroupParseInvitation analysieren.

Rückgabewert

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

Hinweis Wenn ein Löschvorgang aufgrund eines Dateisystemfehlers fehlschlägt, wird der entsprechende Dateisystemfehler zurückgegeben.

Rückgabecode	Beschreibung
E_ACCESSDENIED	Der Zugriff auf die Peergruppendatenbank wird verweigert. Stellen Sie sicher, dass der Peer über die Berechtigung zum Ausführen dieses Vorgangs verfügt. In diesem Fall muss der Peer der ursprüngliche Ersteller der Peergruppe sein.
E_INVALIDARG	Einer der Parameter ist ungültig.
PEER_E_NOT_FOUND	Die Peergruppe kann nicht gefunden werden.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Identitäts- oder Peergruppenschlüssel wird verweigert. Dies wird in der Regel durch eine falsche Zugriffssteuerungsliste (Access Control List, ACL) für den Ordner verursacht, der die Benutzer- oder Computerschlüssel enthält. Dies kann passieren, wenn die ACL manuell zurückgesetzt wird.

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

Hinweise

Wenn eine Peergruppe gelöscht wird, werden alle dieser Gruppe zugeordneten Handles sofort ungültig. Stellen Sie als bewährte Methode sicher, dass alle Handles für diese Gruppe geschlossen sind, bevor Sie diese Funktion aufrufen. Andernfalls werden diese Daten aus allen anderen ausgeführten Peeranwendungen gelöscht, die sie verwenden, was zu Fehlern und Instabilität führen kann.

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

PeerGroupCreate

Freigeben über