ZwAllocateLocallyUniqueId 함수(ntddk.h)
ZwAllocateLocallyUniqueId 루틴은 LUID(로컬 고유 식별자)를 할당합니다.
구문
NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
PLUID Luid
);
매개 변수
Luid
원본 LUID 구조체의 복사본을 수신하기 위해 호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼는 적어도 sizeof(LUID)여야 합니다.
반환 값
ZwAllocateLocallyUniqueId 는 작업이 성공하면 STATUS_SUCCESS 반환하거나 작업이 실패할 경우 적절한 NTSTATUS 값을 반환합니다. 출력 매개 변수를 쓸 수 없는 경우 루틴은 STATUS_ACCESS_VIOLATION 반환합니다.
설명
할당된 LUID 는 로컬 시스템에만 고유하며 시스템이 다음에 다시 시작될 때까지만 고유성이 보장됩니다.
ZwAllocateLocallyUniqueId 함수에 대한 호출이 사용자 모드에서 발생하는 경우 "ZwAllocateLocallyUniqueId" 대신 "NtAllocateLocallyUniqueId"라는 이름을 사용해야 합니다.
커널 모드 드라이버에서 호출하는 경우 Windows 네이티브 시스템 서비스 루틴의 NtXxx 및 ZwXxx 버전은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. 루틴의 NtXxx 버전과 ZwXxx 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴의 Nt 및 Zw 버전 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntddk.h(Ntddk.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport) |