Compartir a través de

Función SplitSymbols (imagehlp.h)

  • Artículo

Quita símbolos de la imagen especificada.

Sintaxis

BOOL IMAGEAPI SplitSymbols(
  [in]  PSTR  ImageName,
  [in]  PCSTR SymbolsPath,
  [out] PSTR  SymbolFilePath,
  [in]  ULONG Flags
);

Parámetros

[in] ImageName

Nombre de la imagen de la que se van a dividir los símbolos.

[in] SymbolsPath

Subdirectorio para almacenar símbolos. Este parámetro es opcional.

[out] SymbolFilePath

Nombre del archivo de símbolos generado. Este archivo normalmente tiene una extensión .dbg.

[in] Flags

Información que se va a dividir de la imagen. Este parámetro puede ser cero o una combinación de los valores siguientes.

Valor Significado
SPLITSYM_EXTRACT_ALL
0x00000002
 Normalmente, una imagen con los símbolos divididos seguirá con un directorio de depuración MISC con el nombre del archivo de símbolos. Por lo tanto, el depurador todavía puede encontrar los símbolos. El uso de esta marca quita este vínculo. El resultado final es similar al uso del modificador -debug:none en el enlazador de Microsoft.
SPLITSYM_REMOVE_PRIVATE
0x00000001
 Esto quita la información simbólica de CodeView privada al generar el archivo de símbolos.
SPLITSYM_SYMBOLPATH_IS_SRC
0x00000004
 La ruta de acceso del archivo de símbolos contiene una ruta de acceso alternativa para buscar el archivo .pdb.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La función SplitSymbols debe usarse al quitar símbolos de una imagen. Creará un archivo de símbolos que comprendan todos los depuradores compatibles. El formato se define en WinNT.h y consta de un encabezado de imagen, seguido de la matriz de encabezados de sección, la información de FPO y toda la depuración de información simbólica de la imagen.

Si el parámetro SymbolsPath es NULL, el archivo de símbolos se almacena en el directorio donde existe la imagen. De lo contrario, se almacena en el subdirectorio siguiente SymbolsPath que coincide con la extensión de la imagen. El uso de este método reduce las posibilidades de colisión de archivos de símbolos. Por ejemplo, los símbolos de myapp.exe estarán en el directorio SymbolsPath\exe y los símbolos de myapp.dll estarán en el directorio SymbolsPath\dll.

Todas las funciones ImageHlp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imagehlp.h
Library Imagehlp.lib
Archivo DLL Imagehlp.dll

Consulte también

Funciones ImageHlp