Funzione PeerGroupCreate (p2p.h)

Articolo
03/15/2023

La funzione PeerGroupCreate crea un nuovo gruppo di peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Parametri

[in] pProperties

Puntatore a una struttura di PEER_GROUP_PROPERTIES che specifica i dettagli specifici del gruppo, ad esempio i nomi dei gruppi peer, la durata degli inviti e la durata della presenza. Questo parametro è obbligatorio.

È necessario impostare i membri seguenti:

pwzCreatorPeerName

Non è possibile impostare i membri seguenti:

pwzGroupPeerName

I membri rimanenti sono facoltativi.

[out] phGroup

Restituisce il puntatore dell'handle al gruppo peer. Qualsiasi funzione chiamata con questo handle come parametro ha l'azione corrispondente eseguita su tale gruppo di peer. 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 l'operazione specificata.
PEER_E_CLOUD_NAME_AMBIGUOUS	Il cloud specificato in pProperties non può essere individuato in modo univoco (più di un cloud corrisponde al nome specificato).
PEER_E_INVALID_CLASSIFIER	Il classificatore del gruppo peer specificato in pProperties non è valido.
PEER_E_INVALID_PEER_NAME	Il nome peer specificato per il gruppo in pProperties non è valido.
PEER_E_INVALID_PROPERTIES	Una o più proprietà del gruppo di peer fornite in pProperties non sono valide.
PEER_E_NO_CLOUD	Impossibile trovare il cloud specificato in pProperties .
PEER_E_NO_KEY_ACCESS	L'accesso all'identità o alle chiavi di gruppo viene negato. In genere, ciò è causato da un elenco di controllo di accesso non corretto (ACL) per la cartella che contiene le chiavi utente o computer. Ciò può verificarsi quando l'ACL viene reimpostato manualmente.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	La password specificata non soddisfa i requisiti delle password di sistema.
ERROR_DELETE_PENDING	L'identità peer specificata come Autore del gruppo è stata eliminata o sta per essere eliminata.

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

PeerGroupConnect deve essere chiamato dall'autore del gruppo immediatamente dopo la creazione. Se questa operazione non viene eseguita, gli utenti che hanno ricevuto un invito chiameranno PeerGroupConnect correttamente, ma non saranno in grado di ascoltare e riceveranno l'evento di connessione non riuscito.

Un'applicazione ottiene un'identità chiamando PeerIdentityCreate o qualsiasi altro metodo che restituisce una stringa di nome identità. Questa identità funge da proprietario del gruppo ed è il membro iniziale del gruppo peer al momento della creazione.

Per le applicazioni che utilizzano le password, è consigliabile che le password vengano gestite 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

PeerGroupClose

PeerGroupConnect

PeerGroupOpen

Share via