Condividi tramite


Funzione PeerGroupSetProperties (p2p.h)

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

Vedi anche

PEER_GROUP_PROPERTIES

PeerGroupCreate

PeerGroupGetProperties

PeerGroupJoin

PeerGroupOpen