Auf Englisch lesen

Freigeben über


ORPC_DBG_ALL Struktur

Die ORPC_DBG_ALL-Struktur wird verwendet, um Parameter an die Methoden der IOrpcDebugNotify-Schnittstelle zu übergeben.

Hinweis

Jede Methode der IOrpcDebugNotify-Schnittstelle verwendet eine andere Kombination der folgenden Elemente. Wenn ein Element nicht als von einer -Methode verwendet angegeben wird, ist es nicht definiert, wenn es an diese Methode übergeben wird.

Syntax

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;

Member

pSignature

Ein Zeiger auf einen BYTE-Puffer , der Folgendes enthält:

  • Erste vier Bytes: die ASCII-Zeichen "MARB" in zunehmender Speicherreihenfolge.
  • Nächste 16 Bytes: Eine GUID , die die aufgerufene Benachrichtigung identifiziert. Sie enthält eine der folgenden Elemente:
    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
  • Nächste vier Bytes: Für die zukünftige Verwendung reserviert.

Hinweis

Wird von allen Methoden der IOrpcDebugNotify-Schnittstelle verwendet.

pMessage

Ein Zeiger auf eine RPCOLEMESSAGE-Struktur , die RPC-Daten marshalling-Informationen enthält.

Refiid

Ein Zeiger auf die IID der IOrpcDebugNotify-Schnittstelle .

pChannel

Ein Zeiger auf die IRpcChannelBuffer-Schnittstelle der COM RPC-Kanalimplementierung auf dem Server.

Hinweis

Wird von den Methoden ServerFillBuffer, ServerGetBufferSize und ServerNotify verwendet.

pUnkProxyMgr

Ein Zeiger auf die IUnknown-Schnittstelle des Objekts, das an diesem Debuggeraufruf beteiligt ist. Kann NULL sein, dies reduziert jedoch die Debuggerfunktionalität.

Hinweis

Wird von den Methoden ClientFillBuffer, ClientGetBufferSize und ClientNotify verwendet.

pInterface

Ein Zeiger auf die COM-Schnittstelle der Methode, die von diesem RPC aufgerufen wird. Darf nicht NULL sein.

Hinweis

Wird von den Methoden ServerFillBuffer, ServerGetBufferSize und ServerNotify verwendet.

pUnkObject

Muss NULL sein.

Hinweis

Wird von den Methoden ServerFillBuffer, ServerGetBufferSize und ServerNotify verwendet.

Hresult

Der Zweck dieses Mitglieds ändert sich für jede der folgenden Benachrichtigungen:

ClientGetBufferSize: Die Anzahl der Bytes, die der Clientdebugger an den Serverdebugger sendet. Wenn null, müssen keine Informationen übertragen werden.

ClientNotify: das HRESULT des letzten RPC.

ServerGetBufferSize: Die Anzahl der Bytes, die der Clientdebugger an den Serverdebugger sendet. Wenn null, müssen keine Informationen übertragen werden.

Hinweis

Wird von den Methoden ClientGetBufferSize, ClientNotify und ServerGetBufferSize verwendet.

pvBuffer

Ein Zeiger auf eine ORPC_DBG_BUFFER-Struktur , die die Rpc-Debuginformationen enthält. Ist nicht definiert, wenn cbBuffer null ist.

cbBuffer

Die Länge der Daten in Bytes, auf die von pvBuffer verwiesen wird.

lpcbBuffer

Die Anzahl der Bytes, die der Clientdebugger an den Serverdebugger sendet. Wenn null, müssen keine Informationen übertragen werden. Dieser Wert ersetzt den in hresult zurückgegebenen Wert.

Hinweis

Wird von den Methoden ClientFillBuffer, ClientGetBufferSize verwendet.

reserved

Reserviert. Darf nicht verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
N/V

Siehe auch

ORPC_DBG_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify