Fungsi IoCreateSymbolicLink (wdm.h)
Rutinitas IoCreateSymbolicLink menyiapkan tautan simbolis antara nama objek perangkat dan nama yang terlihat pengguna untuk perangkat.
Sintaks
NTSTATUS IoCreateSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parameter
[in] SymbolicLinkName
Penunjuk ke string Unicode yang di-buffer yang merupakan nama yang terlihat pengguna.
[in] DeviceName
Penunjuk ke string Unicode yang di-buffer yang merupakan nama objek perangkat yang dibuat driver.
Nilai kembali
IoCreateSymbolicLink mengembalikan STATUS_SUCCESS jika objek tautan simbolis dibuat.
Keterangan
Driver WDM tidak memberi nama objek perangkat dan oleh karena itu tidak boleh menggunakan rutinitas ini. Sebagai gantinya, driver WDM harus memanggil IoRegisterDeviceInterface untuk menyiapkan tautan simbolis.
Untuk informasi selengkapnya tentang kapan menggunakan IoCreateSymbolicLink, lihat Objek Perangkat Bernama.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Aturan kepatuhan DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |