Fungsi IoCreateSymbolicLink (wdm.h)

  • Artikel

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)

Lihat juga

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface