Compartir a través de


Método IDebugEventCallbacksWide::ChangeSymbolState (dbgeng.h)

El motor llama al método de devolución de llamada ChangeSymbolState cuando cambia el estado del símbolo.

Sintaxis

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Parámetros

[in] Flags

Especifica un conjunto de bits que indica la naturaleza del cambio en el estado del símbolo. Es posible que se establezcan las marcas de bits siguientes.

Valor Descripción
DEBUG_CSS_LOADS El motor ha cargado algunos símbolos de módulo.
DEBUG_CSS_UNLOADS El motor ha descargado algunos símbolos de módulo.
DEBUG_CSS_SCOPE El ámbito del símbolo actual ha cambiado.
DEBUG_CSS_PATHS Las rutas de acceso de búsqueda de símbolos, origen o imagen ejecutable han cambiado.
DEBUG_CSS_SYMBOL_OPTIONS Las opciones de símbolo han cambiado.
DEBUG_CSS_TYPE_OPTIONS Las opciones de tipo han cambiado.

[in] Argument

Proporciona información adicional sobre el cambio en el estado del símbolo. Si se establece más de una marca de bits en el parámetro Flags , no se usa el parámetro Argument . De lo contrario, el valor de Argument depende del valor de Flags:

DEBUG_CSS_LOADS

El valor de Argument es la ubicación base (en el espacio de direcciones de memoria del destino) de la imagen del módulo para la que el motor cargó símbolos.

DEBUG_CSS_UNLOADS

El valor de Argument es la ubicación base (en el espacio de direcciones de memoria del destino) de la imagen del módulo para la que el motor descargó símbolos. Si el motor descargó símbolos para más de una imagen, el valor de Argument es cero.

DEBUG_CSS_SCOPE

El valor de Argument es cero.

DEBUG_CSS_PATHS

El valor de Argument es cero.

DEBUG_CSS_SYMBOL_OPTIONS

El valor de Argument es las opciones de símbolo.

DEBUG_CSS_TYPE_OPTIONS

El valor de Argument es cero.

Valor devuelto

El motor omite el valor devuelto a menos que indique un error de llamada a procedimiento remoto; en este caso, el cliente, con el que se registra este objeto IDebugEventCallbacksWide , está deshabilitado.

Comentarios

El motor llama a este método solo si la marca de DEBUG_EVENT_CHANGE_SYMBOL_STATE está establecida en la máscara devuelta por IDebugEventCallbacksWide::GetInterestMask.

Para obtener más información sobre cómo controlar eventos, consulte Supervisión de eventos.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)