Función RegisterForRuntimeStartup

Ejecuta la devolución de llamada cuando el entorno de ejecución de .NET se inicia en el proceso especificado.

Sintaxis

HRESULT RegisterForRuntimeStartup (
    [in] DWORD dwProcessId,
    [in] PSTARTUP_CALLBACK pfnCallback,
    [in] PVOID parameter,
    [out] PVOID *ppUnregisterToken)
);

Parámetros

dwProcessId
[in] Identificador de proceso del proceso de destino.

pfnCallback
[in] Devolución de llamada que se invoca cuando se inicia el tiempo de ejecución. Consulte PSTARTUP_CALLBACK puntero de función.

parameter
[in] puntero de datos pasado a pfnCallback.

ppUnregisterToken
[out] puntero para devolver el token UnregisterForRuntimeStartup .

Valor devuelto

S_OK
La devolución de llamada de inicio se registró correctamente.

E_INVALIDARG
pfnCallback O es ppUnregisterToken null.

E_FAIL (u otros E_ códigos de retorno)
Error en el registro de devolución de llamada.

Observaciones

La devolución de llamada se pasa a la instancia de ICorDebug adecuada para la versión del tiempo de ejecución o un error si se produce un error. Esta API funciona para el inicio y la asociación (e incluso para el escenario de asociación si el tiempo de ejecución aún no se ha cargado) en xplat y Windows. La devolución de llamada siempre se llama en un subproceso independiente. Esta API devuelve inmediatamente. La devolución de llamada se invoca cuando se carga el módulo en tiempo de ejecución de Coreclr durante la inicialización temprana. El tiempo de ejecución se bloquea durante la inicialización hasta que se devuelve la devolución de llamada. Si el tiempo de ejecución ya está cargado en el proceso (como en el caso adjunto normal), la devolución de llamada se ejecuta y el tiempo de ejecución no está bloqueado. La devolución de llamada siempre se invoca en un subproceso independiente y esta API devuelve inmediatamente. Actualmente solo se admite la primera instancia del módulo coreclr que se encuentra en el proceso de destino.

Requisitos

Plataformas: Consulte Sistemas operativos compatibles con .NET.

Encabezado: dbgshim.h

Biblioteca: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versiones de .NET: Disponible desde .NET Core 2.1