Función SymSrvGetSupplement (dbghelp.h)
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 |