Funzione PeerGroupGetProperties (p2p.h)

Articolo
03/01/2024

La funzione PeerGroupGetProperties recupera informazioni sulle proprietà di un gruppo specificato.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

Parametri

[in] hGroup

Handle in un gruppo peer le cui proprietà vengono recuperate. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[out] ppProperties

Puntatore a una struttura PEER_GROUP_PROPERTIES contenente informazioni sulle proprietà del gruppo peer. Questi dati devono essere liberati con PeerFreeData. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_GROUP_NOT_READY	Il gruppo non è in uno stato in cui è possibile recuperare le proprietà del gruppo peer. Ad esempio, PeerGroupJoin viene chiamato, ma la sincronizzazione con il database del gruppo non è stata completata.
PEER_E_INVALID_GROUP	L'handle al gruppo di peer non è valido.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

Le proprietà del gruppo non possono essere recuperate se un peer non è sincronizzato con un database del gruppo di peer. Per sincronizzare con un database del gruppo peer prima di chiamare questa funzione, chiamare prima PeerGroupConnect.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll