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

Artigo
02/06/2025

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.

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
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 manter o nome do arquivo executável e foi truncado.

Observações

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 and Processes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Partilhar via