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

Consulte también

Funciones de DbgHelp

SymSrvGetSupplement