Función SymSrvStoreSupplementW (dbghelp.h)

Almacena un archivo en el complemento especificado en un almacén de símbolos. El archivo normalmente está asociado a un archivo en el servidor de símbolos.

Sintaxis

PCWSTR IMAGEAPI SymSrvStoreSupplementW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR Node,
  [in]           PCWSTR 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] SymPath

Ruta de acceso al almacén de símbolos.

[in] Node

Archivo de símbolo 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 se produce un error en la función, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.

Observaciones

Un uso importante para 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ían en el directorio siguiente: 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 Complemento. 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 solo subproceso. Por lo tanto, las llamadas de más de un subproceso a esta función probablemente provocarán un comportamiento inesperado o daños en la memoria. Para evitar esto, 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

Consulte también

funciones dbgHelp de

SymSrvGetSupplement