Método IDebugClient4::GetRunningProcessSystemIdByExecutableName (dbgeng.h)
O método GetRunningProcessSystemIdByExecutableName pesquisa um processo com um determinado nome de arquivo executável e retorna sua ID de processo.
Sintaxe
HRESULT GetRunningProcessSystemIdByExecutableName(
[in] ULONG64 Server,
[in] PCSTR ExeName,
[in] ULONG Flags,
[out] PULONG Id
);
Parâmetros
[in] Server
Especifica o servidor de processo para pesquisar o nome executável. Se Servidor for zero, o mecanismo procurará o nome executável entre os processos em execução no computador local.
[in] ExeName
Especifica o nome do arquivo executável para o qual pesquisar.
[in] Flags
Especifica um conjunto de bits que controla como o nome executável é correspondido. Os seguintes sinalizadores podem estar presentes:
| Bandeira | Descrição |
|---|---|
| DEBUG_GET_PROC_FULL_MATCH |
ExeName especifica o nome do caminho completo do nome do arquivo executável.
Se esse sinalizador não estiver definido, esse método não usará nomes de caminho ao pesquisar o processo. |
| DEBUG_GET_PROC_ONLY_MATCH | Exigir que apenas um processo corresponda ao nome do arquivo executável ExeName. |
[out] Id
Recebe a ID do processo do primeiro processo para corresponder ExeName .
Valor de retorno
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Mais de um processo correspondeu ao nome do arquivo executável em ExeName e DEBUG_GET_PROC_ONLY_MATCH foi definido em Flags. |
|
Nenhum processo correspondeu ao nome do arquivo executável em ExeName. |
Observações
Esse método está disponível apenas para depuração dinâmica do modo de usuário.
Para obter mais informações sobre como criar e anexar a destinos de modo de usuário dinâmico, consulte de Destinos do Live User-Mode .
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |
Consulte também
do AttachProcess