Función PeerDistStartup (peerdist.h)

  • Artículo

La función PeerDistStartup crea un nuevo identificador de instancia de distribución del mismo nivel que se debe pasar a todas las demás API de distribución del mismo nivel.

Sintaxis

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

Parámetros

[in] dwVersionRequested

Contiene la versión mínima de la distribución del mismo nivel solicitada por la aplicación. El byte de orden alto especifica el número de versión secundaria; el byte de orden bajo especifica el número de versión principal.

[out] phPeerDist

Puntero a una variable de PEERDIST_INSTANCE_HANDLE que, tras el éxito, recibe un identificador recién creado.

[out, optional] pdwSupportedVersion

Puntero a una variable que, si no es NULL, contiene el número de versión máximo admitido por el sistema de distribución del mismo nivel. El byte de orden alto especifica el número de versión secundaria; el byte de orden bajo especifica el número de versión principal.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS. De lo contrario, es posible que la función devuelva uno de los siguientes valores:

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios parámetros no son válidos.
PEERDIST_ERROR_VERSION_UNSUPPORTED
 La versión solicitada no es compatible con la DLL del lado cliente.

Comentarios

Se debe llamar a PeerDistStartup antes de cualquier otra función de distribución del mismo nivel. Cuando ya no sea necesario, el identificador devuelto por PeerDistStartup debe cerrarse a través de una llamada a PeerDistShutdown.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado peerdist.h
Library PeerDist.lib
Archivo DLL PeerDist.dll

Consulte también

PeerDistShutdown