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

El método ExtendHostContext lo usan los hosts que admiten la recepción de datos antiguos sin formato arbitrarios (POD) dentro de un contexto de host. Este método amplía la noción de un contexto de host con un tamaño específico de los datos POD.

Sintaxis

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

Parámetros

blobSize

Variable ULONG que indica el tamaño del blob de datos que se va a almacenar en el contexto de host. identificador

identifier

Valor REFGUID que proporciona un identificador para el contexto de host que se extiende.

blobId

Puntero a una variable ULONG de salida que se usa para recibir un identificador único que se puede usar para establecer y recuperar los datos en cualquier objeto de contexto de host.

Valor devuelto

Si el método se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Observaciones

Los datos almacenados dentro de un contexto de host deben ser datos intrínsecos sin formato: no puede ser una interfaz COM; no puede ser nada que requiera destrucción, y debe ser lo más pequeño posible.

A menos que los datos se agreguen explícitamente a través del método IDebugHostContextExtensibility, ningún contexto de host contendrá dichos datos.

Requisitos

Consulte también

interfaz IDebugHostExtensibility3