Função SymSrvDeltaNameW (dbghelp.h)

Artigo
11/20/2024

Gera o nome de um arquivo que descreve a relação entre duas versões diferentes do mesmo símbolo ou arquivo de imagem. O uso desse recurso impede que os aplicativos tenham que regenerar essas informações sempre que analisarem dois arquivos.

Sintaxe

PCWSTR IMAGEAPI SymSrvDeltaNameW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR Type,
  [in]           PCWSTR File1,
  [in]           PCWSTR File2
);

Parâmetros

[in] hProcess

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

[in, optional] SymPath

O caminho do símbolo. A função usa apenas os repositórios de símbolos descritos na sintaxe padrão para repositórios de símbolos. Todos os outros caminhos são ignorados. Se esse parâmetro for NULL, a função usará o conjunto de caminhos de símbolo usando a função SymInitialize SymInitialize ou SymSetSearchPath.

[in] Type

A extensão do nome do arquivo gerado.

[in] File1

O caminho da primeira versão do arquivo de símbolo ou imagem.

[in] File2

O caminho da segunda versão do arquivo de símbolo ou imagem.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será o nome do arquivo resultante.

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

Observações

Essa função abre os dois arquivos especificados, lê as informações de indexação do cabeçalho e passa essas informações para o servidor de símbolos para que ele possa criar o nome do arquivo. Se você especificar o parâmetro Type como "xml", o nome será o índice de File1, seguido por um traço, seguido pelo índice de File2, seguido por uma extensão .xml. Por exemplo:

3F3D5C755000-3F3D647621000.xml

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

Todas as funções DbgHelp, como esta, são threaded simples. 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.

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

Nota

O cabeçalho dbghelp.h define SymSrvDeltaName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	dbghelp.h
biblioteca	Dbghelp.lib
de DLL	Dbghelp.dll
redistribuível	DbgHelp.dll 6.3 ou posterior

Consulte também

do DbgHelp Functions

Compartilhar via