大网数据广告活动
Windows 系统接口

ORPC_DBG_BUFFER structure

· 52CE 我爱测

The ORPC_DBG_BUFFER structure is the buffer format used to marshalled RPC data to the methods of the IOrpcDebugNotify interface.

The ORPC_DBG_BUFFER structure is the buffer format used to marshalled RPC data to the methods of the IOrpcDebugNotify interface.

Syntax

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;

Members

alwaysOrSometimes

A value that controls debugger spawning. alwaysOrSometimes can be one of the following values:

Value Meaning
ORPC_DEBUG_ALWAYS 0x00000000 If set, COM will always raise the client or server notification on the receiver.
ORPC_DEBUG_IF_HOOK_ENABLED 0x00000001 If set, COM will only raise the client or server notification on the receiver if COM debugging has been enabled by calling DllDebugObjectRPCHook in that process with fTrace set to TRUE.

verMajor

The major version number of the data format specification.

verMinor

The minor version number of the data format specification.

cbRemaining

The number of bytes, inclusive of cbRemaining, that follow in this structure.

guidSemantic

A GUID that determines which members of the union are present below. guidSemantic can take one of the following values:

Value Meaning
9CADE560-8F43-101A-B07B-00DD01113F11 Determines if single stepping is to be performed by the debugger. Only the fStopOnOtherSide member of the union is present below.
D62AEDFA-57EA-11ce-A964-00AA006C3706 Determines if RPC marshalled data and debugging opcodes are passed to the receiver. All of the members of the union are present below with the exception of fStopOnOtherSide.

fStopOnOtherSide

If TRUE, single stepping is performed by the debugger and it should step out of the server and continue execution once the other side is reached. Otherwise, single stepping is not performed and debugger execution stops on the other side.

wDebuggingOpCode

A value that allows for one of a series of operations to be specified. wDebuggingOpCode can take one of the following values:

Value Meaning
0x0000 No operation.
0x0001 If set, single step semantics are identical to fStopOnOtherSide when set to TRUE.

cExtent

Padding. Do not use.

padding

Padding. Do not use.

cb

The size, in bytes of the data in rgbData.

guidExtent

A GUID that determines the type of data in rgbData. guidExtent can take one of the following values:

Value Meaning
53199051-57EB-11ce-A964-00AA006C3706 rgbData is a marshalled interface pointer.

rgbData

A BYTE buffer used to pass RPC marshalled COM data between the client and server debuggers. The contents of rgbData are determined by the GUID in guidExtent.

guidExtent Value rgbData contents
53199051-57EB-11ce-A964-00AA006C3706 A marshalled interface pointer that results from calling CoMarshalInterface. The marshalled pointer is converted into its corresponding interface pointer using CoUnmarshalInterface.

Remarks

This members of this structure have 1-byte alignment and are always transmitted in little-endian byte order.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header N/A

See also

ORPC_DBG_ALL

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。