Lire en anglais

Partager via


ORPC_DBG_ALL 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 BYTE qui contient :

  • Quatre premiers octets : les caractères ASCII « MARB » dans l’ordre croissant de la mémoire.
  • 16 octets suivants : GUID qui identifie la notification appelée. Il contient l’un des éléments suivants :
    1. ClientGetBufferSize : 9ED14F80-9673-101A-B07B-00DDD01113F11
    2. ClientFillBuffer:D A45F3E0-9673-101A-B07B-00DDD01113F11
    3. ClientNotify:4F60E540-9674-101A-B07B-00DDD01113F11
    4. ServerNotify:1084FA00-9674-101A-B07B-00DDD01113F11
    5. ServerGetBufferSize:22080240-9674-101A-B07B-00DDD01113F11
    6. ServerFillBuffer:2FC09500-9674-101A-B07B-00DDD01113F11
  • Quatre octets suivants : réservés 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, ServerGetBufferSize et ServerNotify .

pUnkProxyMgr

Pointeur vers l’interface IUnknown de l’objet impliqué dans cet appel du débogueur. Peut être NULL, mais cela réduit les fonctionnalités du débogueur.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientGetBufferSize et ClientNotify .

pInterface

Pointeur vers l’interface COM de la méthode qui sera appelée par ce RPC. Ne doit pas être NULL.

Notes

Utilisé par les méthodes ServerFillBuffer, ServerGetBufferSize et ServerNotify .

pUnkObject

Doit être NULL.

Notes

Utilisé par les méthodes ServerFillBuffer, ServerGetBufferSize et ServerNotify .

Hresult

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 serveur. Si zéro, aucune information n’a besoin d’être transmise.

ClientNotify : HRESULT du dernier RPC.

ServerGetBufferSize : nombre d’octets que le débogueur client transmet au débogueur serveur. Si zéro, aucune information n’a besoin d’être transmise.

Notes

Utilisé par les méthodes ClientGetBufferSize, ClientNotify et ServerGetBufferSize .

pvBuffer

Pointeur vers une structure de ORPC_DBG_BUFFER qui contient les informations de débogage marshalées RPC. N’est pas défini si cbBuffer est égal à zéro.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientNotify, ServerFillBuffer et ServerNotify .

cbBuffer

Longueur, en octets, des données pointées par pvBuffer.

Notes

Utilisé par les méthodes ClientFillBuffer, ClientNotify, ServerFillBuffer et ServerNotify .

lpcbBuffer

Nombre d’octets que le débogueur client transmettra au débogueur serveur. Si zéro, aucune information n’a besoin d’être transmise. Cette valeur remplace la valeur retournée dans hresult.

Notes

Utilisé par les méthodes ClientFillBuffer et ClientGetBufferSize .

reserved

Réservé. Ne pas utiliser.

Spécifications

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

ORPC_DBG_BUFFER

ORPC_INIT_ARGS

DllDebugObjectRPCHook

IOrpcDebugNotify