Compartilhar via


Método IDebugSymbols3::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 do buffer de.

[out, optional] PathSize

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

Valor de retorno

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

Observações

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
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

AppendImagePath

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

SetImagePath