Funzione PeerGroupStartup (p2p.h)

La funzione PeerGroupStartup avvia un gruppo di peer usando una versione richiesta dell'infrastruttura peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

Parametri

[in] wVersionRequested

Specifica la versione più alta dell'infrastruttura peer che un chiamante può supportare. Il byte di ordine elevato specifica il numero di versione secondaria (revisione). Il byte a basso ordine specifica il numero di versione principale Questo parametro è obbligatorio.

[out] pVersionData

Puntatore a una struttura PEER_VERSION_DATA che contiene il livello specifico di supporto fornito dall'infrastruttura peer. Questo parametro è obbligatorio.

Valore restituito

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

Codice restituito	Descrizione
ERROR_SERVICE_DEPENDENCY_FAIL	Il servizio Peer Name Resolution Protocol (PNRP) deve essere avviato prima di chiamare PeerGroupStartup.
E_OUTOFMEMORY	Non è disponibile memoria sufficiente per completare l'operazione.
PEER_E_IPV6_NOT_INSTALLED	Impossibile avviare il servizio di raggruppamento perché IPv6 non è installato nel computer.
PEER_E_UNSUPPORTED_VERSION	La versione richiesta non è supportata dal sottosistema Peer installato.

 

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

Il servizio PEER Name Resolution Protocol (PNRP) deve essere avviato prima di chiamare questa funzione.

Questa funzione viene chiamata dall'applicazione prima di chiamare qualsiasi altra funzione peer grouping.

Per questa versione, le applicazioni devono usare PEER_GROUP_VERSION come versione richiesta.

Un gruppo peer avviato con questa funzione viene chiuso chiamando PeerGroupShutdown al termine dell'applicazione.

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

Funzioni API di raggruppamento

PEER_VERSION_DATA

PeerGroupShutdown