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 |
|