Прочитать на английском

Поделиться через


структура ORPC_DBG_ALL

Структура ORPC_DBG_ALL используется для передачи параметров методам интерфейса IOrpcDebugNotify .

Примечание

Каждый метод интерфейса IOrpcDebugNotify использует различные сочетания указанных ниже элементов. Если элемент не указан как используемый методом, он не определяется при передаче в этот метод.

Синтаксис

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;

Члены

pSignature

Указатель на буфер BYTE , содержащий:

  • Первые четыре байта: символы ASCII "MARB" в порядке увеличения памяти.
  • Следующие 16 байт: GUID , определяющий вызываемое уведомление. Он содержит одно из следующих компонентов:
    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
  • Следующие четыре байта: зарезервировано для использования в будущем.

Примечание

Используется всеми методами интерфейса IOrpcDebugNotify .

pMessage

Указатель на структуру RPCOLEMESSAGE , содержащую сведения о маршале данных RPC.

Примечание

Используется методами ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize и ServerNotify .

refiid

Указатель на IID интерфейса IOrpcDebugNotify .

Примечание

Используется методами ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize и ServerNotify .

pChannel

Указатель на интерфейс IRpcChannelBuffer реализации канала RPC COM на сервере.

Примечание

Используется методами ServerFillBuffer, ServerGetBufferSize и ServerNotify .

pUnkProxyMgr

Указатель на интерфейс IUnknown объекта, участвующего в вызове отладчика. Может иметь значение NULL, однако это снижает функциональные возможности отладчика.

Примечание

Используется методами ClientFillBuffer, ClientGetBufferSize и ClientNotify .

pInterface

Указатель на COM-интерфейс метода, который будет вызываться этим RPC. Не должно иметь значение NULL.

Примечание

Используется методами ServerFillBuffer, ServerGetBufferSize и ServerNotify .

pUnkObject

Должно иметь значение NULL.

Примечание

Используется методами ServerFillBuffer, ServerGetBufferSize и ServerNotify .

Hresult

Назначение этого участника изменяется для каждого из следующих уведомлений:

ClientGetBufferSize: количество байтов, которые клиентский отладчик будет передавать отладчику сервера. Если значение равно нулю, передача информации не требуется.

ClientNotify: HRESULT последнего RPC.

ServerGetBufferSize: количество байтов, которые клиентский отладчик будет передавать отладчику сервера. Если значение равно нулю, передача информации не требуется.

Примечание

Используется методами ClientGetBufferSize, ClientNotify и ServerGetBufferSize .

pvBuffer

Указатель на структуру ORPC_DBG_BUFFER , содержащую отладочную информацию, маршалированную RPC. Не определено, если cbBuffer равно нулю.

Примечание

Используется методами ClientFillBuffer, ClientNotify, ServerFillBuffer и ServerNotify .

cbBuffer

Длина в байтах данных, на которые указывает pvBuffer.

Примечание

Используется методами ClientFillBuffer, ClientNotify, ServerFillBuffer и ServerNotify .

lpcbBuffer

Число байтов, которые клиентский отладчик будет передавать отладчику сервера. Если значение равно нулю, передача информации не требуется. Это значение заменяет значение, возвращаемое в hresult.

Примечание

Используется методами ClientFillBuffer, ClientGetBufferSize .

Защищены

Зарезервировано. Не используется.

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Н/Д

См. также

ORPC_DBG_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify