struttura ORPC_DBG_ALL
La struttura ORPC_DBG_ALL viene usata per passare parametri ai metodi dell'interfaccia IOrpcDebugNotify .
Nota
Ogni metodo dell'interfaccia IOrpcDebugNotify usa una combinazione diversa dei membri seguenti. Se un membro non viene indicato come utilizzato da un metodo, non è definito quando viene passato a tale metodo.
Sintassi
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;
Members
-
pSignature
-
Puntatore a un buffer BYTE che contiene:
- Primi quattro byte: i caratteri ASCII "MARB" in ordine di memoria crescente.
- 16 byte successivi: GUID che identifica la notifica chiamata. Contiene uno dei seguenti elementi:
- ClientGetBufferSize: 9ED14F80-9673-101A-B07B-00DD01113F11
- ClientFillBuffer:D A45F3E0-9673-101A-B07B-00DD01113F11
- ClientNotify:4F60E540-9674-101A-B07B-00DD01113F11
- ServerNotify:1084FA00-9674-101A-B07B-00DD01113F11
- ServerGetBufferSize:22080240-9674-101A-B07B-00DD01113F11
- ServerFillBuffer:2FC09500-9674-101A-B07B-00DD01113F11
- Quattro byte successivi: riservato per uso futuro.
Nota
Usato da tutti i metodi dell'interfaccia IOrpcDebugNotify .
-
pMessage
-
Puntatore a una struttura RPCOLEMESSAGE che contiene informazioni sul marshalling dei dati RPC.
Nota
Usato dai metodi ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize e ServerNotify .
-
refiid
-
Puntatore all'IID dell'interfaccia IOrpcDebugNotify .
Nota
Usato dai metodi ClientFillBuffer, ClientGetBufferSize, ClientNotify, ServerFillBuffer, ServerGetBufferSize e ServerNotify .
-
pChannel
-
Puntatore all'interfaccia IRpcChannelBuffer dell'implementazione del canale RPC COM nel server.
Nota
Utilizzato dai metodi ServerFillBuffer, ServerGetBufferSize e ServerNotify .
-
pUnkProxyMgr
-
Puntatore all'interfaccia IUnknown dell'oggetto coinvolto nella chiamata al debugger. Può essere NULL, tuttavia, ciò riduce la funzionalità del debugger.
Nota
Usato dai metodi ClientFillBuffer, ClientGetBufferSize e ClientNotify .
-
pInterface
-
Puntatore all'interfaccia COM del metodo che verrà richiamato da questo RPC. Non deve essere NULL.
Nota
Utilizzato dai metodi ServerFillBuffer, ServerGetBufferSize e ServerNotify .
-
pUnkObject
-
Deve essere NULL.
Nota
Utilizzato dai metodi ServerFillBuffer, ServerGetBufferSize e ServerNotify .
-
Hresult
-
Lo scopo di questo membro cambia per ognuna delle notifiche seguenti:
ClientGetBufferSize: il numero di byte che il debugger client trasmetterà al debugger del server. Se zero, non è necessario trasmettere informazioni.
ClientNotify: HRESULT dell'ultima RPC.
ServerGetBufferSize: il numero di byte che il debugger client trasmetterà al debugger del server. Se zero, non è necessario trasmettere informazioni.
Nota
Usato dai metodi ClientGetBufferSize, ClientNotify e ServerGetBufferSize .
-
pvBuffer
-
Puntatore a una struttura di ORPC_DBG_BUFFER che contiene le informazioni di debug con marshalling RPC. Non è definito se cbBuffer è zero.
Nota
Usato dai metodi ClientFillBuffer, ClientNotify, ServerFillBuffer e ServerNotify .
-
cbBuffer
-
Lunghezza, in byte, dei dati a cui punta pvBuffer.
Nota
Usato dai metodi ClientFillBuffer, ClientNotify, ServerFillBuffer e ServerNotify .
-
lpcbBuffer
-
Numero di byte che il debugger client trasmetterà al debugger del server. Se zero, non è necessario trasmettere informazioni. Questo valore sostituisce il valore restituito in hresult.
Nota
Utilizzato dai metodi ClientFillBuffer, ClientGetBufferSize .
-
Riservati
-
Riservato. Non usare.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|