PeerGroupGetProperties-Funktion (p2p.h)
Die Funktion PeerGroupGetProperties ruft Informationen zu den Eigenschaften einer angegebenen Gruppe ab.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
[in] HGROUP hGroup,
[out] PPEER_GROUP_PROPERTIES *ppProperties
);
Parameter
[in] hGroup
Handle für eine Peergruppe, deren Eigenschaften abgerufen werden. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.
[out] ppProperties
Zeiger auf eine PEER_GROUP_PROPERTIES-Struktur , die Informationen zu Peergruppeneigenschaften enthält. Diese Daten müssen mit PeerFreeData freigegeben werden. 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 |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen. |
|
Die Gruppe befindet sich nicht in einem Zustand, in dem Peergruppeneigenschaften abgerufen werden können. Beispielsweise wird PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Gruppendatenbank wurde nicht abgeschlossen. |
|
Das Handle für die Peergruppe ist ungültig. |
Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.
Hinweise
Gruppeneigenschaften können nicht abgerufen werden, wenn ein Peer nicht mit einer Peergruppendatenbank synchronisiert wurde. Um vor dem Aufrufen dieser Funktion mit einer Peergruppendatenbank zu synchronisieren, rufen Sie zuerst PeerGroupConnect auf.
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 |