Función SymSrvStoreSupplement (dbghelp.h)
Almacena un archivo en el complemento especificado en un almacén de símbolos. Normalmente, el archivo está asociado a un archivo en el servidor de símbolos.
Sintaxis
PCSTR IMAGEAPI SymSrvStoreSupplement(
[in] HANDLE hProcess,
[in, optional] PCSTR SrvPath,
[in] PCSTR Node,
[in] PCSTR File,
[in] DWORD Flags
);
Parámetros
[in] hProcess
Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .
[in, optional] SrvPath
Ruta de acceso al almacén de símbolos.
[in] Node
El archivo de símbolos asociado al archivo complementario.
[in] File
Nombre del archivo.
[in] Flags
Si este parámetro es SYMSTOREOPT_COMPRESS, el archivo se comprime en el almacén de símbolos. Actualmente, no hay otros valores admitidos.
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
Un uso importante de esta función es almacenar archivos delta. Para obtener más información, vea SymSrvDeltaName.
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.
El servidor de símbolos almacena archivos complementarios con la misma extensión en un directorio común. Por ejemplo, Sup1.xml se almacenaría en el siguiente directorio: SymPath\supplement\Node\xml.
El administrador de un almacén puede impedir que los usuarios escriban archivos complementarios mediante la creación de un archivo de solo lectura en la raíz del almacén denominado Supplement. Como alternativa, el administrador puede crear el directorio de suplementos y usar ACL para controlar el acceso.
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 |