Fungsi UuidCreateSequential (rpcdce.h)

Artikel
03/15/2023

Fungsi UuidCreateSequential membuat UUID baru.

Sintaks

RPC_STATUS UuidCreateSequential(
  UUID *Uuid
);

Parameter

Uuid

Mengembalikan penunjuk ke UUID yang dibuat.

Menampilkan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_UUID_LOCAL_ONLY	UUID dijamin unik untuk komputer ini saja.
RPC_S_UUID_NO_ADDRESS	Tidak bisa mendapatkan alamat perangkat keras Ethernet atau token-ring untuk komputer ini.

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

Keterangan

Untuk alasan keamanan, UuidCreate dimodifikasi sehingga tidak lagi menggunakan alamat MAC mesin untuk menghasilkan UUID. UuidCreateSequential diperkenalkan untuk memungkinkan pembuatan UUIDmenggunakan alamat MAC kartu Ethernet mesin.

Fungsi UuidCreateSequential mengembalikan RPC_S_UUID_LOCAL_ONLY ketika komputer asal tidak memiliki cincin ethernet/token (IEEE 802.x) alamat. Dalam hal ini, UUID yang dihasilkan adalah pengidentifikasi yang valid, dan dijamin unik di antara semua UUIDyang dihasilkan di komputer. Namun, kemungkinan ada bahwa komputer lain tanpa alamat cincin ethernet/token menghasilkan UUID yang identik. Oleh karena itu Anda tidak boleh menggunakan UUID ini untuk mengidentifikasi objek yang tidak benar-benar lokal ke komputer Anda. Komputer dengan alamat cincin ethernet/token menghasilkan UUIDyang dijamin unik secara global.

Catatan Fungsi UuidCreateSequential cenderung sedikit lebih cepat daripada fungsi UuidCreate . Ketika performa pembuatan UUID adalah pertimbangan yang signifikan, fungsi UuidCreateSequential dapat digunakan.

Persyaratan


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	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

UuidCreate

UuidFromString

UuidToString

Bagikan melalui