PeerGroupSetProperties-Funktion (p2p.h)
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 |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
|
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. |
|
Das Handle für die Peergruppe ist ungültig. |
|
Mindestens eine der angegebenen Eigenschaften ist ungültig. |
|
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. |
|
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 |