estrutura ORPC_DBG_BUFFER
A estrutura ORPC_DBG_BUFFER é o formato de buffer usado para enviar dados RPC para os métodos da interface IOrpcDebugNotify .
Sintaxe
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;
Membros
-
alwaysOrSometimes
-
Um valor que controla a geração do depurador. alwaysOrSometimes pode ser um dos seguintes valores:
Valor Significado - ORPC_DEBUG_ALWAYS
- 0x00000000
Se definido, COM sempre gerará a notificação de cliente ou servidor no receptor. - ORPC_DEBUG_IF_HOOK_ENABLED
- 0x00000001
Se definido, COM só gerará a notificação de cliente ou servidor no receptor se a depuração COM tiver sido habilitada chamando DllDebugObjectRPCHook nesse processo com fTrace definido como TRUE. -
verMajor
-
O número de versão principal da especificação de formato de dados.
-
Verminor
-
O número de versão secundária da especificação de formato de dados.
-
cbRemaining
-
O número de bytes, incluindo cbRemaining, que se seguem nessa estrutura.
-
guidSemantic
-
Um GUID que determina quais membros do sindicato estão presentes abaixo. guidSemantic pode usar um dos seguintes valores:
Valor Significado - 9CADE560-8F43-101A-B07B-00DD011113F11
Determina se a etapa única deve ser executada pelo depurador. Somente o membro fStopOnOtherSide da união está presente abaixo. - D62AEDFA-57EA-11ce-A964-00AA006C3706
Determina se os dados com marshaled RPC e os opcodes de depuração são passados para o receptor. Todos os membros do sindicato estão presentes abaixo, com exceção de fStopOnOtherSide. -
fStopOnOtherSide
-
Se TRUE, a etapa única será executada pelo depurador e ela deverá sair do servidor e continuar a execução quando o outro lado for atingido. Caso contrário, a etapa única não será executada e a execução do depurador será interrompida do outro lado.
-
wDebuggingOpCode
-
Um valor que permite que uma de uma série de operações seja especificada. wDebuggingOpCode pode obter um dos seguintes valores:
Valor Significado - 0x0000
Sem operação. - 0x0001
Se definido, a semântica de etapa única será idêntica a fStopOnOtherSide quando definida como TRUE. -
cExtent
-
Preenchimento. Não use.
-
padding
-
Preenchimento. Não use.
-
cb
-
O tamanho, em bytes dos dados em rgbData.
-
guidExtent
-
Um GUID que determina o tipo de dados em rgbData. guidExtent pode usar um dos seguintes valores:
Valor Significado - 53199051-57EB-11ce-A964-00AA006C3706
rgbData é um ponteiro de interface marshalled. -
rgbData
-
Um buffer BYTE usado para passar dados COM com marshaled RPC entre os depuradores do cliente e do servidor. O conteúdo de rgbData é determinado pelo GUID em guidExtent.
Valor guidExtent conteúdo rgbData 53199051-57EB-11ce-A964-00AA006C3706 Um ponteiro de interface marshalled que resulta da chamada de CoMarshalInterface. O ponteiro marshalled é convertido em seu ponteiro de interface correspondente usando CoUnmarshalInterface.
Comentários
Esses membros dessa estrutura têm alinhamento de 1 byte e são sempre transmitidos em ordem de byte little-endian.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|