Compartilhar via


Função SymSrvStoreFile (dbghelp.h)

Armazena um arquivo no repositório de símbolos especificado.

Sintaxe

PCSTR IMAGEAPI SymSrvStoreFile(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  File,
  [in]           DWORD  Flags
);

Parâmetros

[in] hProcess

Um identificador para um processo. Esse identificador deve ter sido passado anteriormente para a função SymInitialize .

[in, optional] SrvPath

O repositório de símbolos.

[in] File

O nome do arquivo.

[in] Flags

Os sinalizadores que controlam a função. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SYMSTOREOPT_COMPRESS
0x01
Compacte o arquivo.
SYMSTOREOPT_OVERWRITE
0x02
Substitua o arquivo se ele existir.
SYMSTOREOPT_PASS_IF_EXISTS
0x40
Não relate um erro se o arquivo já existir no repositório de símbolos.
SYMSTOREOPT_POINTER
0x08
Armazene em File.ptr.
SYMSTOREOPT_RETURNINDEX
0x04
Retornar somente o índice.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho totalmente qualificado para o arquivo armazenado.

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Essa função retorna um ponteiro para um buffer que pode ser reutilizado por outra função. Portanto, copie os dados retornados para outro buffer imediatamente.

Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dbghelp.h
Biblioteca Dbghelp.lib
DLL Dbghelp.dll
Redistribuível DbgHelp.dll 6.3 ou posterior

Confira também

Funções DbgHelp