Funzione PeerGroupSetProperties (p2p.h)

Articolo
03/15/2023

La funzione PeerGroupSetProperties imposta le proprietà del gruppo di peer corrente. Nella versione 1.0 di questa API, solo il creatore del gruppo peer può eseguire questa operazione.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Parametri

[in] hGroup

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

[in] pProperties

Puntatore a una struttura PEER_GROUP_PROPERTIES popolata da peer che contiene le nuove proprietà. Per ottenere questa struttura, un peer deve prima chiamare PeerGroupGetProperties, modificare i campi appropriati e quindi passarlo come parametro. Questo parametro è obbligatorio.

Non è possibile modificare i membri seguenti di PEER_GROUP_PROPERTIES :

dwSize
pwzCloud
pwzClassifier
pwzGroupPeerName
pwzCreatorPeerName

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_OUTOFMEMORY	Non è disponibile memoria sufficiente per completare l'operazione.
PEER_E_GROUP_NOT_READY	Il gruppo non è in uno stato in cui è possibile impostare le proprietà del gruppo peer. Ad esempio, PeerGroupJoin è stato chiamato, ma la sincronizzazione con il database del gruppo di peer non è completata.
PEER_E_INVALID_GROUP	L'handle al gruppo di peer non è valido.
PEER_E_INVALID_GROUP_PROPERTIES	Una o più delle proprietà specificate non sono valide.
PEER_E_NOT_AUTHORIZED	L'identità corrente non dispone dell'autorizzazione per modificare queste proprietà. In questo caso, l'identità non è l'autore del gruppo peer.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	La password specificata non soddisfa i requisiti delle password di sistema.

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

Per le applicazioni che usano le password, è consigliabile gestire le password in modo sicuro chiamando le funzioni CryptoProtectMemory e SecureZeroMemory .

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