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

El método GetImagePath devuelve la ruta de acceso de la imagen ejecutable.

Sintaxis

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

Parámetros

[out, optional] Buffer

Recibe la ruta de acceso de la imagen ejecutable. Se trata de una cadena que contiene directorios separados por punto y coma (;). Si de búfer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer de búfer.

[out, optional] PathSize

Recibe el tamaño, en caracteres, de la ruta de acceso de la imagen ejecutable.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte valores devueltos para obtener más información.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
S_FALSE	El método se realizó correctamente. Sin embargo, el búfer no era lo suficientemente grande como para contener la ruta de acceso de la imagen ejecutable y la ruta de acceso se truncaba.

Observaciones

El motor usa la ruta de acceso de la imagen ejecutable al buscar imágenes ejecutables.

La ruta de acceso de la imagen ejecutable puede constar de varios directorios separados por punto y coma. Estos directorios se buscan en orden.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Consulte también

AppendImagePath

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

setImagePath