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

IOrpcDebugNotify 介面之 IID的指標。

注意

由 ClientFillBuffer、ClientGetBufferSize、ClientNotify、ServerFillBuffer、ServerGetBufferSize和ServerNotify方法使用。

pChannel

伺服器上 COM RPC 通道實作 之 IRpcChannelBuffer 介面的指標。

注意

由 ServerFillBuffer、 ServerGetBufferSize和 ServerNotify 方法使用。

pUnkProxyMgr

與這個偵錯工具調用相關之物件的 IUnknown 介面指標。 不過，這可能是 Null，這可減少偵錯工具功能。

注意

由 ClientFillBuffer、ClientGetBufferSize和ClientNotify方法使用。

pInterface

這個 RPC 將叫用之方法之 COM 介面的指標。 不得為 Null。

注意

由 ServerFillBuffer、 ServerGetBufferSize和 ServerNotify 方法使用。

pUnkObject

必須是 Null。

注意

由 ServerFillBuffer、 ServerGetBufferSize和 ServerNotify 方法使用。

hresult

此成員針對下列每個通知的用途變更：

ClientGetBufferSize：用戶端偵錯工具將傳輸至伺服器偵錯工具的位元組數目。 如果為零，則不需要傳輸任何資訊。

ClientNotify：最後一個 RPC 的 HRESULT 。

ServerGetBufferSize：用戶端偵錯工具將傳輸至伺服器偵錯工具的位元組數目。 如果為零，則不需要傳輸任何資訊。

注意

ClientGetBufferSize、ClientNotify和ServerGetBufferSize方法使用。

pvBuffer

包含 RPC 封送處理偵錯資訊的 ORPC_DBG_BUFFER 結構的指標。 如果 cbBuffer 為零，則為未定義。

注意

由 ClientFillBuffer、ClientNotify、ServerFillBuffer和ServerNotify方法使用。

cbBuffer

pvBuffer所指向資料的長度，以位元組為單位。

注意

由 ClientFillBuffer、ClientNotify、ServerFillBuffer和ServerNotify方法使用。

lBuffer

用戶端偵錯工具將傳輸至伺服器偵錯工具的位元組數目。 如果為零，則不需要傳輸任何資訊。 這個值會取代 hresult中傳回的值。

注意

ClientFillBuffer、ClientGetBufferSize方法使用。

保留

保留的。 請勿使用。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	N/A

另請參閱

ORPC_DBG_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify