Función ZwAllocateLocallyUniqueId (ntddk.h)
La rutina ZwAllocateLocallyUniqueId asigna un identificador único local (LUID).
Sintaxis
NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
PLUID Luid
);
Parámetros
Luid
Puntero a un búfer asignado por el autor de la llamada para recibir una copia de la estructura LUID de origen. El búfer debe tener al menos sizeof(LUID).
Valor devuelto
ZwAllocateLocallyUniqueId devuelve STATUS_SUCCESS si la operación se realiza correctamente o el valor NTSTATUS adecuado si se produce un error en la operación. Si el parámetro de salida no se puede escribir en, la rutina devuelve STATUS_ACCESS_VIOLATION.
Comentarios
El LUID asignado es único solo para el sistema local y solo se garantiza la unicidad hasta que se reinicie el sistema.
Si la llamada a la función ZwAllocateLocallyUniqueId se produce en modo de usuario, debe usar el nombre "NtAllocateLocallyUniqueId" en lugar de "ZwAllocateLocallyUniqueId".
En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntddk.h (incluya Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport) |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema