Fungsi IoCreateUnprotectedSymbolicLink (wdm.h)

  • Artikel

Rutinitas IoCreateUnprotectedSymbolicLink menyiapkan tautan simbolis yang tidak terlindungi antara nama objek perangkat dan nama Win32 yang terlihat sesuai.

Sintaks

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

Parameter

[in] SymbolicLinkName

Memasok nama tautan simbolis sebagai string Unicode.

[in] DeviceName

Menyediakan nama objek perangkat yang dirujuk oleh nama tautan simbolis.

Nilai kembali

IoCreateUnprotectedSymbolicLink mengembalikan status akhir operasi.

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.

IoCreateUnprotectedSymbolicLink dapat digunakan oleh driver jika pengguna perlu dapat memanipulasi tautan simbolis. Misalnya, driver paralel dan serial membuat tautan simbolis yang tidak terlindungi untuk LPTx dan COMx, sehingga pengguna dapat memanipulasi dan menetapkan ulang dengan menggunakan perintah MODE.

Secara umum, driver harus memanggil rutinitas ini alih-alih IoCreateSymbolicLink jika subsistem yang dilindungi memungkinkan pengguna akhir mengubah seperti apa referensi perangkat bernama, misalnya, saat menggunakan LPT1 untuk mengakses printer jaringan.

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), IrqlIoPassive4(wdm), PowerIrpDDis(wdm)

Lihat juga

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface