Función SymSrvStoreFileW (dbghelp.h)

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

Sintaxis

PCWSTR IMAGEAPI SymSrvStoreFileW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SrvPath,
  [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] 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 siguientes valores.

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

Observaciones

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.

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

Consulte también

funciones dbgHelp de