Método IDebugHostExtensibility3::ExtendHostContext (dbgmodel.h)

Artigo
01/30/2025

O método ExtendHostContext é usado por hosts que dão suporte ao recebimento de POD (dados antigos simples arbitrários) dentro de um contexto de host. Esse método estende a noção de um contexto de host com um tamanho específico de dados POD.

Sintaxe

HRESULT ExtendHostContext(
  ULONG   blobSize,
  REFGUID identifier,
  ULONG   *blobId
);

Parâmetros

blobSize

Uma variável ULONG que indica o tamanho do blob de dados a ser armazenado no contexto do host. identificador

identifier

Um valor REFGUID que fornece um identificador para o contexto do host que é estendido.

blobId

Um ponteiro para uma variável ULONG de saída que é usada para receber um identificador exclusivo que pode ser usado para definir e recuperar os dados em qualquer objeto de contexto de host.

Valor de retorno

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Os dados armazenados dentro de um contexto de host devem ser dados intrínsecos simples: não podem ser uma interface COM; não pode ser nada que exija destruição, e deve ser o menor possível.

A menos que os dados sejam adicionados explicitamente por meio da interface IDebugHostContextExtensibility método, nenhum contexto de host conterá esses dados.

Requisitos

Requisito	Valor
cabeçalho	dbgmodel.h

Consulte também

interface IDebugHostExtensibility3

Compartilhar via