Compartir a través de

estructura de ORPC_DBG_ALL

  • Artículo

La estructura ORPC_DBG_ALL se usa para pasar parámetros a los métodos de la interfaz IOrpcDebugNotify .

Nota

Cada método de la interfaz IOrpcDebugNotify usa una combinación diferente de los miembros siguientes. Si un miembro no se indica como lo usa un método, no está definido cuando se pasa a ese método.

Sintaxis

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;

Miembros

pSignature

Puntero a un búfer BYTE que contiene:

  • Primeros cuatro bytes: los caracteres ASCII "MARB" en orden de memoria creciente.
  • 16 bytes siguientes: GUID que identifica la notificación a la que se llama. Contiene uno de los siguientes elementos:
    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
  • Siguiente cuatro bytes: reservado para uso futuro.

Nota

Usado por todos los métodos de la interfaz IOrpcDebugNotify .

pMessage

Puntero a una estructura RPCOLEMESSAGE que contiene información de serialización de datos RPC.

Nota

Usado por los métodos ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize y ServerNotify .

refiid

Puntero al IID de la interfaz IOrpcDebugNotify .

Nota

Usado por los métodos ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize y ServerNotify .

pChannel

Puntero a la interfaz IRpcChannelBuffer de la implementación del canal RPC COM en el servidor.

Nota

Usado por los métodos ServerFillBuffer, ServerGetBufferSize y ServerNotify .

pUnkProxyMgr

Puntero a la interfaz IUnknown del objeto implicado en esta invocación del depurador. Sin embargo, puede ser NULL, lo que reduce la funcionalidad del depurador.

Nota

Usado por los métodos ClientFillBuffer, ClientGetBufferSize y ClientNotify .

pInterface

Puntero a la interfaz COM del método que invocará este RPC. No debe ser NULL.

Nota

Usado por los métodos ServerFillBuffer, ServerGetBufferSize y ServerNotify .

pUnkObject

Debe ser NULL.

Nota

Usado por los métodos ServerFillBuffer, ServerGetBufferSize y ServerNotify .

hresult

El propósito de este miembro cambia para cada una de las notificaciones siguientes:

ClientGetBufferSize: el número de bytes que el depurador de cliente transmitirá al depurador del servidor. Si es cero, no es necesario transmitir información.

ClientNotify: HRESULT del último RPC.

ServerGetBufferSize: el número de bytes que el depurador de cliente transmitirá al depurador del servidor. Si es cero, no es necesario transmitir información.

Nota

Usado por los métodos ClientGetBufferSize, ClientNotify y ServerGetBufferSize .

pvBuffer

Puntero a una estructura de ORPC_DBG_BUFFER que contiene la información de depuración serializado rpc. No está definido si cbBuffer es cero.

Nota

Usado por los métodos ClientFillBuffer, ClientNotify, ServerFillBuffer y ServerNotify .

cbBuffer

Longitud, en bytes, de los datos a los que apunta pvBuffer.

Nota

Usado por los métodos ClientFillBuffer, ClientNotify, ServerFillBuffer y ServerNotify .

lpcbBuffer

Número de bytes que el depurador de cliente transmitirá al depurador de servidor. Si es cero, no es necesario transmitir información. Este valor reemplaza el valor devuelto en hresult.

Nota

Usado por los métodos ClientFillBuffer, ClientGetBufferSize .

reserved

Reservado. No utilizar.

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_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify