Compartir a través de

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

  • Artículo

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 La imagen ejecutable, las rutas de acceso de búsqueda de símbolos o de origen 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 Argumento 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 los símbolos descargados del motor para más de una imagen, el valor de Argumento es cero.

DEBUG_CSS_SCOPE

El valor de argumento es cero.

DEBUG_CSS_PATHS

El valor de argumento es cero.

DEBUG_CSS_SYMBOL_OPTIONS

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

DEBUG_CSS_TYPE_OPTIONS

El valor de argumento 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 este IDebugEventCallbacks objeto está registrado, está deshabilitado.

Observaciones

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

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)