Função RegisterForRuntimeStartup3

Executa o retorno de chamada quando o tempo de execução do .NET é iniciado no processo especificado.

Sintaxe

HRESULT RegisterForRuntimeStartup3 (
    [in] DWORD dwProcessId,
    [in] LPCWSTR lpApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [in] PSTARTUP_CALLBACK pfnCallback,
    [in] PVOID parameter,
    [out] PVOID *ppUnregisterToken)
);

Parâmetros

dwProcessId
[em] A ID do processo do processo de destino.

lpApplicationGroupId
[em] Uma cadeia de caracteres que representa a ID do grupo de aplicativos de um processo em área restrita em execução no Mac. Passe NULL se o processo não estiver sendo executado em uma área restrita e em outras plataformas.

pLibraryProvider
[em] Uma instância de interface de retorno de chamada para localizar DBI e DAC. Consulte ICLRDebuggingLibraryProvider3 interface.

pfnCallback
[em] Um retorno de chamada que é invocado quando o tempo de execução é 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
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.

Esta é a única função de registro que funciona para aplicativos de arquivo único.

Requerimentos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: dbgshim.h

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

Versões .NET: Disponível desde: .NET 6.0