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

O método GetRunningProcessSystemIdByExecutableName procura um processo com um determinado nome de arquivo executável e retorna sua ID do 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 o 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:

Sinalizador Descrição
DEBUG_GET_PROC_FULL_MATCH ExeName especifica o nome completo do caminho 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.

Valor retornado

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 no ExeName e DEBUG_GET_PROC_ONLY_MATCH foi definido em Sinalizadores.
E_NOINTERFACE
Nenhum processo correspondeu ao nome do arquivo executável no 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

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (include Dbgeng.h)

Confira também

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

Idebugclient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5