Função "RegisterForRuntimeStartup"

Executa o retorno de chamada quando o runtime do .NET é iniciado no processo especificado.

Sintaxe

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

Parâmetros

dwProcessId
[in] A ID do processo de destino.

pfnCallback
[in] Um retorno de chamada que é invocado quando o runtime é iniciado. Consulte PSTARTUP_CALLBACK ponteiro de função.

parameter
[in] ponteiro de dados passado para pfnCallback.

ppUnregisterToken
[out] ponteiro para retornar o token UnregisterForRuntimeStartup .

Valor de retorno

S_OK
O retorno de chamada de inicialização foi registrado com êxito.

E_INVALIDARG
pfnCallback Ou ppUnregisterToken é nulo.

E_FAIL (ou outros E_ códigos de retorno)
Falha no registro de retorno de chamada.

Observações

O retorno de chamada é passado pela instância ICorDebug adequada para a versão do runtime ou um erro se algo falhar. Essa API funciona para iniciar e anexar (e até mesmo o cenário de anexação se o runtime ainda não tiver sido carregado) igualmente no xplat e no Windows. O retorno de chamada é sempre chamado em um thread separado. Essa API retorna imediatamente. O retorno de chamada é invocado quando o módulo de runtime do coreclr é carregado durante a inicialização antecipada. O runtime é bloqueado durante a inicialização até que o retorno de chamada seja retornado. Se o runtime já estiver carregado no processo (como no caso de anexação normal), o retorno de chamada será executado e o runtime não será bloqueado. O retorno de chamada é sempre invocado em um thread separado e essa API retorna imediatamente. No momento, há suporte apenas para a primeira instância do módulo coreclr encontrada no processo de destino.

Requisitos

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: dbgshim.h

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

Versões do .NET: Disponível desde o .NET Core 2.1