NdrStubForwardingFunction-Funktion (rpcproxy.h)

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.

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