ZwAllocateLocallyUniqueId-Funktion (ntddk.h)
Die ZwAllocateLocallyUniqueId-Routine weist einen lokal eindeutigen Bezeichner (LUID) zu.
Syntax
NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
PLUID Luid
);
Parameter
Luid
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um eine Kopie der Quell-LUID-Struktur zu empfangen. Der Puffer muss mindestens sizeof(LUID) sein.
Rückgabewert
ZwAllocateLocallyUniqueId gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder den entsprechenden NTSTATUS-Wert, wenn der Vorgang fehlschlägt. Wenn der Ausgabeparameter nicht in geschrieben werden kann, gibt die Routine STATUS_ACCESS_VIOLATION zurück.
Hinweise
Die zugeordnete LUID ist nur für das lokale System eindeutig, und die Eindeutigkeit ist nur bis zum nächsten Neustart des Systems garantiert.
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, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntddk.h (include Ntddk.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport) |