Partilhar via

estrutura ORPC_DBG_ALL

  • Artigo

A estrutura ORPC_DBG_ALL é usada para passar parâmetros para os métodos da interface IOrpcDebugNotify .

Observação

Cada método da interface IOrpcDebugNotify usa uma combinação diferente dos membros abaixo. Se um membro não for indicado como usado por um método, ele será indefinido quando passado para esse método.

Sintaxe

typedef struct ORPC_DBG_ALL {
  BYTE              *pSignature;
  RPCOLEMESSAGE     *pMessage;
  const IID         *refiid;
  IRpcChannelBuffer *pChannel;
  IUnknown          *pUnkProxyMgr;
  void              *pInterface;
  IUnknown          *pUnkObject;
  HRESULT           hresult;
  void              *pvBuffer;
  ULONG             *cbBuffer;
  ULONG             *lpcbBuffer;
  void              *reserved;
} ORPC_DBG_ALL, *LPORPC_DBG_ALL;

Membros

pSignature

Um ponteiro para um buffer BYTE que contém:

  • Primeiros quatro bytes: os caracteres ASCII "MARB" em ordem de memória crescente.
  • Próximos 16 bytes: um GUID que identifica a notificação que está sendo chamada. Ele contém um dos seguintes:
    1. ClientGetBufferSize: 9ED14F80-9673-101A-B07B-00DD01113F11
    2. ClientFillBuffer:D A45F3E0-9673-101A-B07B-00DD01113F11
    3. ClientNotify:4F60E540-9674-101A-B07B-00DD01113F11
    4. ServerNotify:1084FA00-9674-101A-B07B-00DD01113F11
    5. ServerGetBufferSize:22080240-9674-101A-B07B-00DD01113F11
    6. ServerFillBuffer:2FC09500-9674-101A-B07B-00DD01113F11
  • Próximos quatro bytes: reservados para uso futuro.

Observação

Usado por todos os métodos da interface IOrpcDebugNotify .

pMessage

Um ponteiro para uma estrutura RPCOLEMESSAGE que contém informações de marshaling de dados RPC.

Observação

Usado pelos métodos ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize e ServerNotify .

Refiid

Um ponteiro para o IID da interface IOrpcDebugNotify .

Observação

Usado pelos métodos ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize e ServerNotify .

pChannel

Um ponteiro para a interface IRpcChannelBuffer da implementação do canal COM RPC no servidor.

Observação

Usado pelos métodos ServerFillBuffer, ServerGetBufferSize e ServerNotify .

pUnkProxyMgr

Um ponteiro para a interface IUnknown do objeto envolvido nessa invocação do depurador. Pode ser NULL, no entanto, isso reduz a funcionalidade do depurador.

Observação

Usado pelos métodos ClientFillBuffer, ClientGetBufferSize e ClientNotify .

pInterface

Um ponteiro para a interface COM do método que será invocado por esse RPC. Não deve ser NULL.

Observação

Usado pelos métodos ServerFillBuffer, ServerGetBufferSize e ServerNotify .

Punkobject

Deve ser NULL.

Observação

Usado pelos métodos ServerFillBuffer, ServerGetBufferSize e ServerNotify .

hresult

A finalidade desse membro é alterada para cada uma das notificações abaixo:

ClientGetBufferSize: o número de bytes que o depurador do cliente transmitirá para o depurador de servidor. Se zero, nenhuma informação precisa ser transmitida.

ClientNotify: o HRESULT do último RPC.

ServerGetBufferSize: o número de bytes que o depurador do cliente transmitirá para o depurador de servidor. Se zero, nenhuma informação precisa ser transmitida.

Observação

Usado pelos métodos ClientGetBufferSize, ClientNotify e ServerGetBufferSize .

Pvbuffer

Um ponteiro para uma estrutura ORPC_DBG_BUFFER que contém as informações de depuração com marshaling de RPC. Será indefinido se cbBuffer for zero.

Observação

Usado pelos métodos ClientFillBuffer, ClientNotify, ServerFillBuffer e ServerNotify .

cbBuffer

O comprimento, em bytes, dos dados apontados por pvBuffer.

Observação

Usado pelos métodos ClientFillBuffer, ClientNotify, ServerFillBuffer e ServerNotify .

Lpcbbuffer

O número de bytes que o depurador do cliente transmitirá para o depurador do servidor. Se zero, nenhuma informação precisa ser transmitida. Esse valor substitui o valor retornado em hresult.

Observação

Usado pelos métodos ClientFillBuffer, ClientGetBufferSize .

reserved

Reservado. Não use.

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
N/D

Confira também

ORPC_DBG_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify