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.
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
-
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 :
- ClientGetBufferSize : 9ED14F80-9673-101A-B07B-00DDD01113F11
- ClientFillBuffer:D A45F3E0-9673-101A-B07B-00DDD01113F11
- ClientNotify:4F60E540-9674-101A-B07B-00DDD01113F11
- ServerNotify:1084FA00-9674-101A-B07B-00DDD01113F11
- ServerGetBufferSize:22080240-9674-101A-B07B-00DDD01113F11
- 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.
Notes
Utilisé par les méthodes ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize et ServerNotify .
-
refiid
-
Pointeur vers l’IID de l’interface IOrpcDebugNotify .
Notes
Utilisé par les méthodes ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize et ServerNotify .
-
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.
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 |
|