Compartilhar via

Função SymAddSourceStream (dbghelp.h)

  • Artigo

Adiciona o fluxo ao módulo especificado para uso pelo Servidor de Origem.

Sintaxe

BOOL IMAGEAPI SymAddSourceStream(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCSTR   StreamFile,
  [in, optional] PBYTE   Buffer,
  [in]           size_t  Size
);

Parâmetros

[in] hProcess

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

[in] Base

O endereço base do módulo.

[in, optional] StreamFile

Uma cadeia de caracteres terminada em nulo que contém o caminho absoluto ou relativo para um arquivo que contém o fluxo de indexação de origem. Pode ser NULL se Buffer não for NULL.

[in, optional] Buffer

Um buffer que contém o fluxo de indexação de origem. Pode ser NULL se StreamFile não for NULL.

[in] Size

Tamanho, em bytes , do buffer de buffer.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

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

Comentários

SymAddSourceStream adiciona um fluxo de dados formatados para uso pelo servidor de origem a um módulo designado. O chamador pode passar o fluxo como um buffer no parâmetro Buffer ou um arquivo no parâmetro StreamFile . Se ambos os parâmetros forem preenchidos, a função usará o parâmetro Buffer . Se ambos os parâmetros forem NULL, a função retornará FALSE e o código do último erro será definido como ERROR_INVALID_PARAMETER.

É importante observar que SymAddSourceStream não adiciona o fluxo a nenhum PDB correspondente para persistir os dados. Essa função é usada por aqueles que implementam programaticamente seus próprios depuradores em cenários em que um PDB não está disponível.

Requisitos

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