estructura de ORPC_DBG_BUFFER

La estructura ORPC_DBG_BUFFER es el formato de búfer que se usa para serializar datos RPC en los métodos de la interfaz IOrpcDebugNotify .

Sintaxis

typedef struct _ORPC_DBG_BUFFER {
  DWORD alwaysOrSometimes;
  BYTE  verMajor;
  BYTE  verMinor;
  DWORD cbRemaining;
  GUID  guidSemantic;
  union {
    BOOL   fStopOnOtherSide;
    USHORT wDebuggingOpCode;
    USHORT cExtent;
    BYTE   padding[2];
    struct {
      ULONG cb;
      GUID  guidExtent;
      BYTE  *rgbData;
    };
  };
} ORPC_DBG_BUFFER, *PORPC_DBG_BUFFER;

Miembros

alwaysOrSometimes

Valor que controla la creación del depurador. alwaysOrSometimes puede ser uno de los siguientes valores:

Valor	Significado
ORPC_DEBUG_ALWAYS 0x00000000	Si se establece, COM siempre generará la notificación de cliente o servidor en el receptor.
ORPC_DEBUG_IF_HOOK_ENABLED 0x00000001	Si se establece, COM solo generará la notificación de cliente o servidor en el receptor si se ha habilitado la depuración COM llamando a DllDebugObjectRPCHook en ese proceso con fTrace establecido en TRUE.

verMajor

Número de versión principal de la especificación de formato de datos.

verMinor

Número de versión secundaria de la especificación de formato de datos.

cbRemaining

Número de bytes, incluido cbRemaining, que sigue en esta estructura.

guidSemantic

Guid que determina qué miembros de la unión están presentes a continuación. guidSemantic puede tomar uno de los siguientes valores:

Valor	Significado
9CADE560-8F43-101A-B07B-00DD01113F11	Determina si el depurador va a realizar una sola ejecución paso a paso. Solo el miembro fStopOnOtherSide de la unión está presente a continuación.
D62AEDFA-57EA-11ce-A964-00AA006C3706	Determina si los datos serialados rpc y los códigos de operación de depuración se pasan al receptor. Todos los miembros de la unión están presentes a continuación con la excepción de fStopOnOtherSide.

fStopOnOtherSide

Si es TRUE, el depurador realiza una sola ejecución paso a paso y debe salir del servidor y continuar la ejecución una vez que se alcanza el otro lado. De lo contrario, no se realiza la ejecución paso a paso único y la ejecución del depurador se detiene en el otro lado.

wDebuggingOpCode

Valor que permite especificar una de una serie de operaciones. wDebuggingOpCode puede tomar uno de los siguientes valores:

Valor	Significado
0x0000	No hay ninguna operación.
0x0001	Si se establece, la semántica de un solo paso es idéntica a fStopOnOtherSide cuando se establece en TRUE.

cExtent

Acolchado. No debe usarse.

padding

Acolchado. No debe usarse.

cb

Tamaño, en bytes de los datos en rgbData.

guidExtent

GUID que determina el tipo de datos en rgbData. guidExtent puede tomar uno de los siguientes valores:

Valor	Significado
53199051-57EB-11ce-A964-00AA006C3706	rgbData es un puntero de interfaz serializado.

rgbData

Un búfer BYTE usado para pasar datos COM serializado rpc entre los depuradores de cliente y servidor. El contenido de rgbData viene determinado por el GUID en guidExtent.

GuidExtent Value	contenido rgbData
53199051-57EB-11ce-A964-00AA006C3706	Puntero de interfaz serializado que resulta de llamar a CoMarshalInterface. El puntero serializado se convierte en su puntero de interfaz correspondiente mediante CoUnmarshalInterface.

Comentarios

Estos miembros de esta estructura tienen alineación de 1 byte y siempre se transmiten en orden de bytes little-endian.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	N/D

Consulte también

ORPC_DBG_ALL

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify