IoCreateUnprotectedSymbolicLink 함수(wdm.h)
IoCreateUnprotectedSymbolicLink 루틴은 디바이스 개체 이름과 해당 Win32 표시 이름 사이에 보호되지 않는 기호 링크를 설정합니다.
구문
NTSTATUS IoCreateUnprotectedSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
매개 변수
[in] SymbolicLinkName
기호 링크 이름을 유니코드 문자열로 제공합니다.
[in] DeviceName
기호 링크 이름이 참조하는 디바이스 개체의 이름을 제공합니다.
반환 값
IoCreateUnprotectedSymbolicLink는 작업의 최종 상태 반환합니다.
설명
WDM 드라이버는 디바이스 개체의 이름을 지정하지 않으므로 이 루틴을 사용하면 안 됩니다. 대신 WDM 드라이버는 IoRegisterDeviceInterface 를 호출하여 기호 링크를 설정해야 합니다.
사용자가 기호 링크를 조작할 수 있어야 하는 경우 드라이버에서 IoCreateUnprotectedSymbolicLink를 사용할 수 있습니다. 예를 들어 병렬 및 직렬 드라이버는 사용자가 MODE 명령을 사용하여 조작하고 다시 할당할 수 있도록 LPTx 및 COMx에 대해 보호되지 않는 기호 링크를 만듭니다.
일반적으로 보호된 하위 시스템을 통해 최종 사용자가 LPT1을 사용하여 네트워크 프린터에 액세스할 때와 같이 명명된 디바이스가 참조하는 항목을 변경할 수 있는 경우 드라이버는 IoCreateSymbolicLink 대신 이 루틴을 호출해야 합니다.
IoCreateSymbolicLink를 사용하는 시기에 대한 자세한 내용은 명명된 디바이스 개체를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |