Compartilhar via


Função GetStartupNotificationEvent

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

Sintaxe

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

Parâmetros

debuggeePID
[in] Identificador de processo do processo de destino do qual receber notificações de inicialização clr.

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

Valor de retorno

S_OK
Obteve 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 que qualquer código gerenciado seja executado pelo CLR que sinalizou o evento.

Requisitos

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: dbgshim.h

Biblioteca: dbgshim.dll

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