Função GetStartupNotificationEvent

Artigo
09/22/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. Esta API é apenas para Windows.

Sintaxe

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

Parâmetros

debuggeePID
[em] Identificador de processo do processo de destino a partir do qual receber notificações de inicialização CLR.

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

Valor devolvido

S_OK
Obtido com êxito 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 E_ códigos de retorno)
Não é possível obter o identificador para o evento de notificação de inicialização.

Observações

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

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

Requisitos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: dbgshim.h

Biblioteca: dbgshim.dll

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

Partilhar via