Funzione PeerDistStartup (peerdist.h)

Articolo
03/01/2024

La funzione PeerDistStartup crea un nuovo handle di istanza di distribuzione peer che deve essere passato a tutte le altre API di distribuzione peer.

Sintassi

DWORD PeerDistStartup(
  [in]            DWORD                     dwVersionRequested,
  [out]           PPEERDIST_INSTANCE_HANDLE phPeerDist,
  [out, optional] PDWORD                    pdwSupportedVersion
);

Parametri

[in] dwVersionRequested

Contiene la versione minima della distribuzione peer richiesta dall'applicazione. Il byte di ordine elevato specifica il numero di versione secondaria; il byte a basso ordine specifica il numero di versione principale.

[out] phPeerDist

Puntatore a una variabile PEERDIST_INSTANCE_HANDLE che al termine dell'operazione riceve un handle appena creato.

[out, optional] pdwSupportedVersion

Puntatore a una variabile che, se non NULL, contiene il numero di versione massimo supportato dal sistema di distribuzione peer. Il byte di ordine elevato specifica il numero di versione secondaria; il byte a basso ordine specifica il numero di versione principale.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. In caso contrario, la funzione può restituire uno dei valori seguenti:

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.
PEERDIST_ERROR_VERSION_UNSUPPORTED	La versione richiesta non è supportata dalla DLL lato client.

Commenti

PeerDistStartup deve essere chiamato prima di qualsiasi altra funzione di distribuzione peer. Quando non è più necessario, l'handle restituito da PeerDistStartup deve essere chiuso tramite una chiamata a PeerDistShutdown.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 Professional [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	peerdist.h
Libreria	PeerDist.lib
DLL	PeerDist.dll

Vedi anche

PeerDistShutdown

Condividi tramite