Compartilhar via


Método IDebugSymbols2::GetImagePath (dbgeng.h)

O método GetImagePath retorna o caminho da imagem executável.

Sintaxe

HRESULT GetImagePath(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG PathSize
);

Parâmetros

[out, optional] Buffer

Recebe o caminho da imagem executável. Essa é uma cadeia de caracteres que contém diretórios separados por ponto e vírgula (;). Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer de buffer .

[out, optional] PathSize

Recebe o tamanho, em caracteres, do caminho da imagem executável.

Retornar valor

Esse método também pode retornar outros 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 manter o caminho da imagem executável e o caminho foi truncado.

Comentários

O caminho da imagem executável é usado pelo mecanismo ao pesquisar imagens executáveis.

O caminho da imagem executável pode consistir em vários diretórios separados por ponto e vírgula. Esses diretórios são pesquisados em ordem.

Requisitos

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

Confira também

AppendImagePath

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

SetImagePath