Fungsi ZwAllocateLocallyUniqueId (ntddk.h)

Rutinitas ZwAllocateLocallyUniqueId mengalokasikan pengidentifikasi unik lokal (LUID).

Sintaks

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Parameter

Luid

Arahkan ke buffer yang dialokasikan penelepon untuk menerima salinan struktur LUID sumber. Buffer harus setidaknya ukuranof (LUID).

Nilai kembali

ZwAllocateLocallyUniqueId mengembalikan STATUS_SUCCESS jika operasi berhasil atau nilai NTSTATUS yang sesuai jika operasi gagal. Jika parameter output tidak dapat ditulis, rutinitas mengembalikan STATUS_ACCESS_VIOLATION.

Keterangan

LUID yang dialokasikan hanya unik untuk sistem lokal, dan keunikan hanya dijamin sampai sistem dimulai ulang berikutnya.

Jika panggilan ke fungsi ZwAllocateLocallyUniqueId terjadi dalam mode pengguna, Anda harus menggunakan nama "NtAllocateLocallyUniqueId" alih-alih "ZwAllocateLocallyUniqueId".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Lihat juga

LUID

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli