Funzione PeerGroupGetProperties (p2p.h)
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 |
|---|---|
|
Uno dei parametri non è valido. |
|
Memoria insufficiente per eseguire un'operazione specificata. |
|
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. |
|
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 |