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)

추가 정보

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface