struktur ORPC_DBG_BUFFER

Struktur ORPC_DBG_BUFFER adalah format buffer yang digunakan untuk menduplikasi data RPC ke metode antarmuka IOrpcDebugNotify .

Sintaks

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;

Anggota

alwaysOrSometimes

Nilai yang mengontrol pemijahan debugger. alwaysOrSometimes bisa menjadi salah satu nilai berikut:

Nilai Makna
ORPC_DEBUG_ALWAYS
0x00000000
Jika diatur, COM akan selalu menaikkan pemberitahuan klien atau server pada penerima.
ORPC_DEBUG_IF_HOOK_ENABLED
0x00000001
Jika diatur, COM hanya akan menaikkan pemberitahuan klien atau server pada penerima jika penelusuran kesalahan COM telah diaktifkan dengan memanggil DllDebugObjectRPCHook dalam proses tersebut dengan fTrace diatur ke TRUE.

verMajor

Nomor versi utama spesifikasi format data.

verMinor

Nomor versi minor dari spesifikasi format data.

cbRemaining

Jumlah byte, termasuk cbRemaining, yang mengikuti dalam struktur ini.

guidSemantic

GUID yang menentukan anggota serikat mana yang ada di bawah ini. guidSemantic dapat mengambil salah satu nilai berikut:

Nilai Makna
9CADE560-8F43-101A-B07B-00DD01113F11
Menentukan apakah langkah tunggal akan dilakukan oleh debugger. Hanya anggota fStopOnOtherSide dari serikat yang ada di bawah ini.
D62AEDFA-57EA-11ce-A964-00AA006C3706
Menentukan apakah data yang di-marshalled RPC dan opcode debugging diteruskan ke penerima. Semua anggota serikat hadir di bawah ini dengan pengecualian fStopOnOtherSide.

fStopOnOtherSide

Jika TRUE, langkah tunggal dilakukan oleh debugger dan harus keluar dari server dan melanjutkan eksekusi setelah sisi lain tercapai. Jika tidak, langkah tunggal tidak dilakukan dan eksekusi debugger berhenti di sisi lain.

wDebuggingOpCode

Nilai yang memungkinkan salah satu dari serangkaian operasi ditentukan. wDebuggingOpCode dapat mengambil salah satu nilai berikut:

Nilai Makna
0x0000
Tidak ada operasi.
0x0001
Jika diatur, semantik langkah tunggal identik dengan fStopOnOtherSide saat diatur ke TRUE.

cExtent

Padding. Jangan gunakan.

Padding

Padding. Jangan gunakan.

cb

Ukuran, dalam byte data dalam rgbData.

guidExtent

GUID yang menentukan jenis data dalam rgbData. guidExtent dapat mengambil salah satu nilai berikut:

Nilai Makna
53199051-57EB-11ce-A964-00AA006C3706
rgbData adalah penunjuk antarmuka marshalled.

rgbData

Buffer BYTE digunakan untuk meneruskan data COM yang di-marshalasi RPC antara klien dan debugger server. Konten rgbData ditentukan oleh GUID di guidExtent.

nilai guidExtent konten rgbData
53199051-57EB-11ce-A964-00AA006C3706 Penunjuk antarmuka marshalled yang dihasilkan dari panggilan CoMarshalInterface. Penunjuk marshalled dikonversi menjadi penunjuk antarmuka yang sesuai menggunakan CoUnmarshalInterface.

Keterangan

Anggota struktur ini memiliki keselarasan 1 byte dan selalu ditransmisikan dalam urutan byte little-endian.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
Windows 2000 Server [hanya aplikasi desktop]
Header
T/A

Lihat juga

ORPC_DBG_ALL

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify