Método IDebugDataSpaces4::ReadTagged (dbgeng.h)

Artigo
02/23/2024

O método ReadTagged lê os dados marcados que podem estar associados a uma sessão do depurador.

Sintaxe

HRESULT ReadTagged(
  [in]            LPGUID Tag,
  [in]            ULONG  Offset,
  [out, optional] PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TotalSize
);

Parâmetros

[in] Tag

Especifica o GUID que identifica os dados solicitados.

[in] Offset

Especifica o deslocamento dentro dos dados a serem lidos.

[out, optional] Buffer

Recebe os dados. Se Buffer for NULL, os dados não serão retornados.

[in] BufferSize

Especifica o tamanho em bytes do buffer Buffer. Esse é o número máximo de bytes que serão retornados.

[out, optional] TotalSize

Recebe o tamanho total em bytes dos dados especificados por Tag.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_NOINTERFACE	Nenhum dado identificado por Tag foi encontrado.

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

Algumas sessões do depurador têm dados adicionais arbitrários disponíveis. Por exemplo, quando um arquivo de despejo é criado, arquivos de informações de despejo adicionais que contêm informações extras também podem ser criados. Esses dados adicionais são marcados com um identificador exclusivo global e só podem ser recuperados por meio da marca .

LPGUID é um ponteiro para um identificador exclusivo de 128 bits. Ele é definido no arquivo de cabeçalho SDK do Microsoft Windows guiddef.h.