Compartir a través de

Función SymSrvGetSupplement (dbghelp.h)

  • Artículo

Recupera el archivo especificado del complemento para un almacén de símbolos.

Sintaxis

PCSTR IMAGEAPI SymSrvGetSupplement(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  Node,
  [in]           PCSTR  File
);

Parámetros

[in] hProcess

Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .

[in, optional] SymPath

Ruta de acceso del símbolo. La función usa solo los almacenes de símbolos descritos en sintaxis estándar para los almacenes de símbolos. Se omiten todas las demás rutas de acceso. Si este parámetro es NULL, la función usa la ruta de acceso del símbolo establecida mediante la función SymInitialize o SymSetSearchPath .

[in] Node

El archivo de símbolos asociado al archivo complementario.

[in] File

Nombre del archivo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es la ruta de acceso completa para el archivo complementario.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

Para obtener más información sobre los archivos complementarios, consulte SymSrvStoreSupplement.

Esta función devuelve un puntero a un búfer que otra función puede reutilizar. Por lo tanto, asegúrese de copiar los datos devueltos a otro búfer inmediatamente.

Todas las funciones DbgHelp, 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.

Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dbghelp.h
Library Dbghelp.lib
Archivo DLL Dbghelp.dll
Redistribuible DbgHelp.dll 6.3 o posterior

Consulte también

Funciones de DbgHelp

SymSrvStoreSupplement