ZwAllocateLocallyUniqueId-Funktion (ntddk.h)

Die ZwAllocateLocallyUniqueId Routine weist einen lokal eindeutigen Bezeichner zu (LUID).

Syntax

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Parameter

Luid

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um eine Kopie der Quell-LUID-Struktur zu erhalten. Der Puffer muss mindestens Größe(LUID-) aufweisen.

Rückgabewert

ZwAllocateLocallyUniqueId gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist oder der entsprechende NTSTATUS-Wert auftritt, wenn der Vorgang fehlschlägt. Wenn der Ausgabeparameter nicht geschrieben werden kann, gibt die Routine STATUS_ACCESS_VIOLATION zurück.

Bemerkungen

Die zugeordnete LUID- ist nur für das lokale System eindeutig, und die Eindeutigkeit wird nur garantiert, bis das System das nächste Mal neu gestartet wird.

Wenn der Aufruf der ZwAllocateLocallyUniqueId Funktion im Benutzermodus auftritt, sollten Sie den Namen "NtAllocateLocallyUniqueId" anstelle von "ZwAllocateLocallyUniqueId" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx und ZwXxx- Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ntddk.h (include Ntddk.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Siehe auch

LUID-

Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienste-Routinen