Método IDebugDataSpaces4::ReadTagged (dbgeng.h)
O método ReadTagged lê os dados marcados que podem estar associados a uma sessão de 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 de 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.
Valor de retorno
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Não foi possível encontrar dados identificados por de Marca. |
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
Observações
Algumas sessões de 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 global exclusivo e só podem ser recuperados por meio da marca.
LPGUID é um ponteiro para um identificador exclusivo de 128 bits. Ele é definido no guiddef.h do arquivo de cabeçalho do SDK do Microsoft Windows.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |