Compartir a través de

Función SymAddSourceStream (dbghelp.h)

  • Artículo

Agrega la secuencia al módulo especificado para que lo use el servidor de origen.

Sintaxis

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

Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .

[in] Base

Dirección base del módulo.

[in, optional] StreamFile

Cadena terminada en null que contiene la ruta de acceso absoluta o relativa a un archivo que contiene el flujo de indexación de origen. Puede ser NULL si Buffer no es NULL.

[in, optional] Buffer

Búfer que contiene el flujo de indexación de origen. Puede ser NULL si StreamFile no es NULL.

[in] Size

Tamaño, en bytes, del búfer de búfer .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

SymAddSourceStream agrega una secuencia de datos con formato para su uso por parte del servidor de origen a un módulo designado. El autor de la llamada puede pasar la secuencia como un búfer en el parámetro Buffer o un archivo en el parámetro StreamFile . Si se rellenan ambos parámetros, la función usa el parámetro Buffer . Si ambos parámetros son NULL, la función devuelve FALSE y el último código de error se establece en ERROR_INVALID_PARAMETER.

Es importante tener en cuenta que SymAddSourceStream no agrega la secuencia a ninguna PDB correspondiente para conservar los datos. Los que implementan mediante programación sus propios depuradores usan esta función en escenarios en los que una PDB no está disponible.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dbghelp.h
Library Dbghelp.lib
Archivo DLL Dbghelp.dll
Redistribuible DbgHelp.dll 6.8 o posterior