Compartir a través de


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

LUID

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema