Compartilhar via


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

O método GetRunningProcessSystemIdByExecutableName procura 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 de 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.

Comentários

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 dinâmicos do modo de usuário, consulte Destinos do Live User-Mode.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

Idebugclient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5