PeerGroupGetProperties-Funktion (p2p.h)

Artikel
08/25/2023

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
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.
PEER_E_GROUP_NOT_READY	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.
PEER_E_INVALID_GROUP	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