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 tamaño de(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.

Observaciones

El LUID asignado es único para el sistema local y la exclusividad solo se garantiza hasta que se reinicie el sistema.

Si la llamada al 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 NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse 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 de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ntddk.h (incluya Ntddk.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Consulte también

LUID

usar versiones Nt y Zw de las rutinas de servicios del sistema nativo