Función SymSrvStoreFile (dbghelp.h)

Almacena un archivo en el almacén de símbolos especificado.

Sintaxis

PCSTR IMAGEAPI SymSrvStoreFile(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [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

Almacén de símbolos.

[in] File

Nombre del archivo.

[in] Flags

Marcas que controlan la función. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
SYMSTOREOPT_COMPRESS 0x01	Comprima el archivo.
SYMSTOREOPT_OVERWRITE 0x02	Sobrescriba el archivo si existe.
SYMSTOREOPT_PASS_IF_EXISTS 0x40	No notifique un error si el archivo ya existe en el almacén de símbolos.
SYMSTOREOPT_POINTER 0x08	Almacenar en File.ptr.
SYMSTOREOPT_RETURNINDEX 0x04	Devuelve solo el índice.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a una cadena terminada en null que especifica la ruta de acceso completa al archivo almacenado.

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

Comentarios

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.

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.

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

Requisitos

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