Função RegisterForRuntimeStartup

Artigo
09/22/2023

Executa o retorno de chamada quando o tempo de execução 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
[em] A ID do processo do processo de destino.

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

parameter
[em] ponteiro de dados passado para pfnCallback.

ppUnregisterToken
[out] ponteiro para retornar o token UnregisterForRuntimeStartup .

Valor devolvido

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

E_INVALIDARG
Ou pfnCallbackppUnregisterToken é nulo.

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

Observações

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

Requisitos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: dbgshim.h

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

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

Partilhar via