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 資料封送處理資訊。

refiid

IOrpcDebugNotify 介面之 IID的指標。

pChannel

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

注意

ServerFillBufferServerGetBufferSizeServerNotify 方法使用。

pUnkProxyMgr

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

pInterface

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

注意

ServerFillBufferServerGetBufferSizeServerNotify 方法使用。

pUnkObject

必須是 Null

注意

ServerFillBufferServerGetBufferSizeServerNotify 方法使用。

hresult

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

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

ClientNotify:最後一個 RPC 的 HRESULT

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

pvBuffer

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

cbBuffer

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

lBuffer

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

注意

ClientFillBufferClientGetBufferSize方法使用。

保留

保留的。 請勿使用。

規格需求

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

另請參閱

ORPC_DBG_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify