estructura de DRT_BOOTSTRAP_PROVIDER (drt.h)
La estructura de DRT_BOOTSTRAP_PROVIDER define la interfaz DRT que debe implementar un 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 |