Método IDebugClient::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Artigo
02/23/2024

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 Server 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:

Sinalizador	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 ao ExeName.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	Mais de um processo correspondeu ao nome do arquivo executável em ExeName e DEBUG_GET_PROC_ONLY_MATCH foi definido em Sinalizadores.
E_NOINTERFACE	Nenhum processo correspondeu ao nome do arquivo executável em ExeName.