PeerGroupSetProperties-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGroupSetProperties-Funktion legt die aktuellen Peergruppeneigenschaften fest. In Version 1.0 dieser API kann nur der Ersteller der Peergruppe diesen Vorgang ausführen.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Parameter

[in] hGroup

Handle mit der Peergruppe, deren Eigenschaften von einem Peer festgelegt werden. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pProperties

Zeiger auf eine mit Peer gefüllte PEER_GROUP_PROPERTIES-Struktur , die die neuen Eigenschaften enthält. Um diese Struktur zu erhalten, muss ein Peer zuerst PeerGroupGetProperties aufrufen, die entsprechenden Felder ändern und sie dann als diesen Parameter übergeben. Dieser Parameter ist erforderlich.

Die folgenden Elemente von PEER_GROUP_PROPERTIES können nicht geändert werden:

dwSize
pwzCloud
pwzClassifier
pwzGroupPeerName
pwzCreatorPeerName

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
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
PEER_E_GROUP_NOT_READY	Die Gruppe befindet sich nicht in einem Zustand, in dem Peergruppeneigenschaften festgelegt werden können. Beispielsweise wurde PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank ist nicht abgeschlossen.
PEER_E_INVALID_GROUP	Das Handle für die Peergruppe ist ungültig.
PEER_E_INVALID_GROUP_PROPERTIES	Mindestens eine der angegebenen Eigenschaften ist ungültig.
PEER_E_NOT_AUTHORIZED	Die aktuelle Identität verfügt nicht über die Berechtigung, diese Eigenschaften zu ändern. In diesem Fall ist die Identität nicht der Ersteller der Peergruppe.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	Das angegebene Kennwort erfüllt nicht die Systemkennwortanforderungen.

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

Hinweise

Für Anwendungen, die Kennwörter verwenden, wird empfohlen, dass die Kennwörter sicher verarbeitet werden, indem die Funktionen CryptoProtectMemory und SecureZeroMemory aufgerufen werden.

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