Função GetStartupNotificationEvent

Artigo
10/04/2023

Cria ou abre um identificador de evento que será sinalizado por qualquer CLR (Common Language Runtime) que esteja sendo carregado no processo de destino especificado. Essa API é somente do Windows.

Sintaxe

HRESULT GetStartupNotificationEvent (
    [in]  DWORD     debuggeePID,
    [out]  HANDLE*  phStartupEvent
);

Parâmetros

debuggeePID
[in] Identificador do processo de destino do qual as notificações de inicialização do CLR devem ser recebidas.

phStartupEvent
[out] Um ponteiro para um identificador que será sinalizado por um CLR na inicialização.

Retornar valor

S_OK
Obteve com sucesso o identificador para o evento de notificação de inicialização.

E_INVALIDARG
phStartupEvent é nulo ou debuggeePID não se refere a um processo que está em execução no momento.

E_FAIL (ou outros códigos de retorno E_)
Não é possível obter o identificador para o evento de notificação de inicialização.

Comentários

No sistema operacional Windows, debuggeePID é mapeado para um identificador de processo do sistema operacional.

O evento é sinalizado antes que qualquer código gerenciado seja executado pelo CLR que sinalizou o evento.

Requisitos

Plataformas: confira Sistemas operacionais com suporte no .NET.

Cabeçalho: dbgshim.h

Biblioteca: dbgshim.dll

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

Compartilhar via