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) |