Método IDebugSystemObjects3::GetCurrentProcessExecutableName (dbgeng.h)

  • Artigo

O método GetCurrentProcessExecutableName retorna o nome do arquivo executável carregado no processo atual.

Sintaxe

HRESULT GetCurrentProcessExecutableName(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExeSize
);

Parâmetros

[out, optional] Buffer

Recebe o nome do arquivo executável. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho em caracteres do buffer Buffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] ExeSize

Recebe o tamanho em caracteres do nome do arquivo executável. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se ExeSize for NULL, essas informações não serão retornadas.

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
 O método foi bem-sucedido. No entanto, o buffer não era grande o suficiente para conter o nome do arquivo executável e foi truncado.

Comentários

Esses métodos só estão disponíveis na depuração no modo de usuário.

Se o mecanismo não puder determinar o nome do arquivo executável, ele gravará a cadeia de caracteres "? NoImage?" para o buffer.

Para obter mais informações sobre processos, consulte Threads e Processos.

Requisitos

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