ORPC _ dbg _ tout (structure)

La structure ORPC _ dbg _ All est utilisée pour passer des paramètres aux méthodes de l’interface IOrpcDebugNotify .

Notes

Chaque méthode de l’interface IOrpcDebugNotify utilise une combinaison différente des membres ci-dessous. Si un membre n’est pas indiqué comme utilisé par une méthode, il n’est pas défini lorsqu’il est passé à cette méthode.

Syntaxe

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;

Membres

pSignature

Pointeur vers une mémoire tampon d' octets qui contient :

  • Quatre premiers octets : caractères ASCII « MARB » dans l’ordre de mémoire plus élevé.
  • 16 octets suivants : GUID qui identifie la notification appelée. Il contient l’un des éléments suivants :
    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
  • Quatre octets suivants : réservé pour une utilisation ultérieure.

Notes

Utilisé par toutes les méthodes de l’interface IOrpcDebugNotify .

pMessage

Pointeur vers une structure RPCOLEMESSAGE qui contient des informations de marshaling de données RPC.

REFIID

Pointeur vers l’IID de l’interface IOrpcDebugNotify .

pChannel

Pointeur vers l’interface IRpcChannelBuffer de l’implémentation du canal RPC com sur le serveur.

Notes

Utilisé par les méthodes ServerFillBuffer, ServerGetBufferSizeet ServerNotify .

pUnkProxyMgr

Pointeur vers l’interface IUnknown de l’objet impliqué dans l’appel de ce débogueur. Peut avoir la valeur null, mais cela réduit la fonctionnalité du débogueur.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientGetBufferSizeet ClientNotify .

pInterface

Pointeur vers l’interface COM de la méthode qui sera appelée par ce RPC. Ne doit pas avoir la valeur null.

Notes

Utilisé par les méthodes ServerFillBuffer, ServerGetBufferSizeet ServerNotify .

pUnkObject

Doit avoir la valeur null.

Notes

Utilisé par les méthodes ServerFillBuffer, ServerGetBufferSizeet ServerNotify .

signé

L’objectif de ce membre change pour chacune des notifications ci-dessous :

ClientGetBufferSize: nombre d’octets que le débogueur client transmet au débogueur de serveur. Si la valeur est zéro, aucune information n’est transmise.

ClientNotify: HRESULT du dernier RPC.

ServerGetBufferSize: nombre d’octets que le débogueur client transmet au débogueur de serveur. Si la valeur est zéro, aucune information n’est transmise.

Notes

Utilisé par les méthodes ClientGetBufferSize, ClientNotifyet ServerGetBufferSize .

pvBuffer

Pointeur vers une structure de _ _ mémoire tampon dbg ORPC qui contient les informations de débogage RPC marshalées. N’est pas défini si cbBuffer est égal à zéro.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientNotify, ServerFillBufferet ServerNotify .

cbBuffer

Longueur, en octets, des données vers lesquelles pointe pvBuffer.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientNotify, ServerFillBufferet ServerNotify .

lpcbBuffer

Nombre d’octets que le débogueur client transmet au débogueur de serveur. Si la valeur est zéro, aucune information n’est transmise. Cette valeur remplace la valeur retournée dans HRESULT.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientGetBufferSize .

reserved

Réservé. Ne pas utiliser.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
En-tête
N/A

Voir aussi

_ _ mémoire tampon dbg ORPC

ORPC _ init _ args

DllDebugObjectRPCHook

IOrpcDebugNotify