Partilhar via


Função GetStartupNotificationEvent

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