Fungsi RpcObjectSetType (rpcdce.h)

Artikel
03/04/2024

Fungsi RpcObjectSetType menetapkan jenis objek.

Sintaks

RPC_STATUS RpcObjectSetType(
  UUID *ObjUuid,
  UUID *TypeUuid
);

Parameter

ObjUuid

Arahkan ke UUID objek untuk dikaitkan dengan UUID jenis dalam parameter TypeUuid .

TypeUuid

Arahkan ke UUID jenis parameter ObjUuid .

Tentukan nilai parameter NULL atau UUID nihil untuk mengatur ulang jenis objek ke asosiasi default UUID objek/UUID nihil-type.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_OBJECT	Objek tidak valid.
RPC_S_ALREADY_REGISTERED	Objek sudah terdaftar.
RPC_S_OUT_OF_MEMORY	Sistem kehabisan memori.

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

Keterangan

Aplikasi server memanggil RpcObjectSetType untuk menetapkan UUID jenis ke UUID objek. Secara default, pustaka run-time RPC secara otomatis menetapkan semua UUID objek dengan UUID jenis nil. Aplikasi server yang berisi satu implementasi antarmuka (satu vektor titik masuk manajer [EPV]) tidak perlu memanggil RpcObjectSetType asalkan server mendaftarkan antarmuka dengan UUID jenis nil (lihat di bawah RpcServerRegisterIf).

Aplikasi server yang berisi beberapa implementasi antarmuka (beberapa EPV manajer—yaitu, beberapa jenis UUID) memanggil RpcObjectSetType sekali untuk setiap asosiasi UUID/UUID jenis non-nihil yang didukung server. Mengaitkan setiap objek dengan UUID jenis memberi tahu pustaka run-time RPC EPV manajer mana (implementasi antarmuka) untuk digunakan ketika server menerima panggilan prosedur jarak jauh untuk UUID objek non-nihil.

Pustaka run-time RPC memungkinkan aplikasi untuk mengatur jenis untuk jumlah objek yang tidak terbatas. Untuk menghapus asosiasi antara UUID objek dan UUID jenisnya (dibuat dengan memanggil RpcObjectSetType), server memanggil RpcObjectSetType lagi, menentukan nilai null atau UUID nihil untuk parameter TypeUuid . Ini mengatur ulang asosiasi UUID/jenis UUID objek ke asosiasi default UUID objek/UUID nil-type. Server tidak dapat menetapkan jenis ke UUID objek nihil. Pustaka run-time RPC secara otomatis menetapkan UUID objek nihil UUID jenis nihil.

Untuk informasi selengkapnya, lihat Mendaftarkan Antarmuka.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

Mendaftarkan Antarmuka

RpcServerRegisterIf

Bagikan melalui