다음을 통해 공유


IoCreateSymbolicLink 함수(wdm.h)

IoCreateSymbolicLink 루틴은 디바이스 개체 이름과 디바이스의 사용자 표시 이름 간에 기호 링크를 설정합니다.

구문

NTSTATUS IoCreateSymbolicLink(
  [in] PUNICODE_STRING SymbolicLinkName,
  [in] PUNICODE_STRING DeviceName
);

매개 변수

[in] SymbolicLinkName

사용자가 볼 수 있는 이름인 버퍼링된 유니코드 문자열에 대한 포인터입니다.

[in] DeviceName

드라이버에서 만든 디바이스 개체의 이름인 버퍼링된 유니코드 문자열에 대한 포인터입니다.

반환 값

IoCreateSymbolicLink 는 기호 링크 개체가 만들어진 경우 STATUS_SUCCESS 반환합니다.

설명

WDM 드라이버는 디바이스 개체의 이름을 지정하지 않으므로 이 루틴을 사용하면 안 됩니다. 대신 WDM 드라이버는 IoRegisterDeviceInterface 를 호출하여 기호 링크를 설정해야 합니다.

IoCreateSymbolicLink를 사용하는 경우에 대한 자세한 내용은 명명된 디바이스 개체를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000부터 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm)

추가 정보

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface