estructura de DRT_BOOTSTRAP_PROVIDER (drt.h)

La estructura de DRT_BOOTSTRAP_PROVIDER define la interfaz DRT que debe implementar un proveedor de arranque.

Nota La infraestructura de DRT no llama simultáneamente a los métodos del proveedor de arranque.

 

Sintaxis

typedef struct drt_bootstrap_provider_tag {
  PVOID    pvContext;
  HRESULT( )(const PVOID pvContext) *Attach;
  VOID( )(const PVOID pvContext)    *Detach;
  HRESULT((const PVOID pvContext,BOOL fSplitDetect,ULONG timeout,ULONG cMaxResults,DRT_BOOTSTRAP_RESOLVE_CONTEXT *ResolveContext,BOOL *fFatalError) * )InitResolve;
  HRESULT()(const PVOID pvContext, const PVOID pvCallbackContext,DRT_BOOTSTRAP_RESOLVE_CALLBACK callback,DRT_BOOTSTRAP_RESOLVE_CONTEXT ResolveContext,BOOL *fFatalError) * IssueResolve;
  VOID( )(const PVOID pvContext,DRT_BOOTSTRAP_RESOLVE_CONTEXT ResolveContext)    *EndResolve;
  HRESULT()(const PVOID pvContext, const SOCKET_ADDRESS_LIST *pAddressList) * Register;
  VOID( )(const PVOID pvContext)    *Unregister;
} DRT_BOOTSTRAP_PROVIDER, *PDRT_BOOTSTRAP_PROVIDER;

Miembros

pvContext

Puntero a datos de contexto definidos por el solucionador de arranque. Al crear un solucionador de arranque, el desarrollador debe rellenar el solucionador con la información necesaria; a menudo, esto ocurre como un puntero "this". Este contexto se pasa a todos los parámetros de contexto de las funciones definidas por el DRT_BOOTSTRAP_PROVIDER.

Attach

Incrementa el recuento de referencias para el proveedor de arranque con un conjunto de DRT.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

Detach

Disminuye el recuento de referencias para el proveedor de arranque con un conjunto de DRT.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

InitResolve

Llamado por la infraestructura de DRT para proporcionar información de configuración sobre las próximas resoluciones de nombres.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

fSplitDetect

Especifica si la operación de resolución se está utilizando para la detección y recuperación de división de red.

timeout

Especifica el tiempo máximo que debe tardar una resolución antes de que se agote el tiempo de espera. Este valor se representa en milisegundos.

cMaxResults

Especifica el número máximo de resultados que se van a devolver durante la operación de resolución.

ResolveContext

Puntero al solucionador de datos específicos.

fFatalError

Si el proveedor de arranque encuentra un error irrecuperable, este parámetro debe establecerse en TRUE cuando la función se complete para que el DRT pase al estado defectuoso. El HRESULT que está disponible para la aplicación de capa superior para la depuración aparecerá en el miembro hr de la estructura de DRT_EVENT_DATA asociada con el evento que señala la transición al estado defectuoso. Esta función del proveedor de arranque no debe devolver S_OK si establece la marca fFatalError en TRUE.

IssueResolve

Lo llama la infraestructura de DRT para emitir una resolución para determinar los puntos de conexión de los nodos que ya están activos en la nube de DRT.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

pvCallbackContext

Puntero a los datos de contexto que se devuelven a la devolución de llamada definida por el parámetro siguiente.

devolución de llamada

Una BOOTSTRAP_RESOLVE_CALLBACK que se llama de nuevo para cada resultado y DRT_E_NO_MORE.

ResolveContext

Puntero al solucionador de datos específicos.

fFatalError

Si el proveedor de arranque encuentra un error irrecuperable, este parámetro debe establecerse en TRUE cuando la función se complete para que el DRT pase al estado defectuoso. El HRESULT que está disponible para la aplicación de capa superior para la depuración aparecerá en el miembro hr de la estructura de DRT_EVENT_DATA asociada con el evento que señala la transición al estado defectuoso. Esta función del proveedor de arranque no debe devolver S_OK si establece la marca fFatalError en TRUE.

EndResolve

Finaliza la resolución de un punto de conexión.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

ResolveContext

El BOOTSTRAP_RESOLVE_CONTEXT recibido de la función Resolve del proveedor de arranque especificado.

Register

Registra un punto de conexión con el mecanismo de arranque. Este proceso permite que otros nodos encuentren el punto de conexión a través del solucionador de arranque.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

pAddressList

Puntero a la lista de direcciones que se van a registrar con el mecanismo de arranque.

Unregister

Esta función anula el registro de un punto de conexión con el mecanismo de arranque. Como resultado, otros nodos no podrán encontrar el nodo local a través de la resolución de arranque.

pvContext

Contiene el valor pvContext de DRT_BOOTSTRAP_PROVIDER.

Requisitos

Cliente mínimo compatible	Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	drt.h