NdrStubForwardingFunction-Funktion (rpcproxy.h)

Artikel
08/25/2023

Die NdrStubForwardingFunction-Funktion ist der Einstiegspunkt für serverseitige Objektmethoden, die in einer Basisschnittstelle definiert sind.

Syntax

void NdrStubForwardingFunction(
  [in]      IRpcStubBuffer    *This,
  [in]      IRpcChannelBuffer *pChannel,
  [in, out] PRPC_MESSAGE      pmsg,
  [out]     DWORD             *pdwStubPhase
);

Parameter

[in] This

Zeiger auf eine instance des CStdStubBuffer-Objekts, das IRpcStubBuffer implementiert, für die DCOM-Schnittstelle.

[in] pChannel

Zeiger auf IRpcChannelBuffer für die DCOM-Schnittstelle, häufig von OLE bereitgestellt.

[in, out] pmsg

Zeiger auf eine RPC_MESSAGE-Struktur , die Informationen zur RPC-Anforderung enthält.

[out] pdwStubPhase

Zeiger auf ein Flag, das die Aktivität des aktuellen Interpreteraufrufs nachverfolgt.

Rückgabewert

Keine

Bemerkungen

Der PdwStubPhase-Parameter wird von der Objektschnittstelle verwendet, um das Verhalten der Ausnahmebehandlung zu bestimmen. In der folgenden Tabelle werden mögliche Werte für den Parameter pdwStubPhase beschrieben.

Wert	BESCHREIBUNG
STUB_UNMARSHAL	Der Stub befindet sich in der Marshallphase.
STUB_CALL_SERVER	Der Stub ruft eine Server-Manager-Routine auf.
STUB_MARSHAL	Der Stub befindet sich in der Entmarshallungsphase.
STUB_CALL_SERVER_NO_HRESULT	Veraltet. Nur für veraltete Stubs.

Für Methoden, die in einer Basisschnittstelle definiert sind, muss RPC den Code an die Basisschnittstellenimplementierung weiterleiten.

Beispiel:

Interface IFunctionSample: IUnknown

{

HRESULT FunctionSample();

}

Interface IOperation: IFunctionSample

{

HRESULT Operation();

}

In diesem Beispiel werden IFunctionSample und IOperation in verschiedenen IDL-Dateien definiert. IFunctionSample ist die Basisschnittstelle und IOperation die abgeleitete Schnittstelle. IOperation kann IOperation aggregieren, ohne IOperation::FunctionSample zu implementieren. Wenn der Client IOperation::FunctionSample aufruft, leitet RPC auf der Serverseite den Aufruf an IFunctionSample:FunctionSample weiter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	rpcproxy.h
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Freigeben über