NdrStubForwardingFunction-Funktion (rpcproxy.h)

  • Artikel

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