Fungsi NdrStubForwardingFunction (rpcproxy.h)

Artikel
03/01/2024

Fungsi NdrStubForwardingFunction adalah titik masuk untuk metode objek sisi server yang ditentukan dalam antarmuka dasar.

Sintaks

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

Parameter

[in] This

Arahkan ke instans objek CStdStubBuffer, menerapkan IRpcStubBuffer, untuk antarmuka DCOM.

[in] pChannel

Pointer ke IRpcChannelBuffer untuk antarmuka DCOM, sering disediakan oleh OLE.

[in, out] pmsg

Arahkan ke struktur RPC_MESSAGE yang berisi informasi tentang permintaan RPC.

[out] pdwStubPhase

Penunjuk ke bendera yang melacak aktivitas panggilan penerjemah saat ini.

Nilai kembali

Tidak ada

Keterangan

Parameter pdwStubPhase digunakan oleh antarmuka objek untuk menentukan perilaku penanganan pengecualian. Tabel berikut ini menjelaskan nilai yang mungkin untuk parameter pdwStubPhase .

Nilai	Deskripsi
STUB_UNMARSHAL	Stub dalam fase marshalling.
STUB_CALL_SERVER	Stub ini memanggil rutinitas manajer server.
STUB_MARSHAL	Stub dalam fase unmarshalling.
STUB_CALL_SERVER_NO_HRESULT	Kedaluwarsa. Hanya untuk stub yang tidak digunakan lagi.

Untuk metode yang didefinisikan dalam antarmuka dasar, RPC perlu meneruskan kode ke implementasi antarmuka dasar.

Contohnya:

Interface IFunctionSample: IUnknown

{

HRESULT FunctionSample();

}

Interface IOperation: IFunctionSample

{

HRESULT Operation();

}

Dalam contoh ini, di mana IFunctionSample dan IOperation didefinisikan dalam file .idl yang berbeda. IFunctionSample adalah antarmuka dasar dan IOperation adalah antarmuka turunan. IOperation dapat mengagregasi IOperation tanpa menerapkan IOperation::FunctionSample. Ketika klien memanggil IOperation::FunctionSample, di sisi server, RPC mengalihkan panggilan ke IFunctionSample:FunctionSample.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	rpcproxy.h
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Bagikan melalui