IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME IOCTL (mountdev.h)

  • Artikel

Dukungan untuk IOCTL ini oleh klien manajer pemasangan bersifat opsional. Beberapa klien mount manager dapat melacak huruf drive mereka di seluruh reboot sistem tanpa bantuan manajer pemasangan. Klien tersebut dapat mengirim nama huruf drive yang disarankan ke manajer pemasangan sebagai respons terhadap IOCTL ini. Manajer pemasangan menggunakan nama yang disarankan jika database manajer pemasangan belum berisi nama huruf drive persisten untuk volume klien. Jika tidak, ia mengabaikan saran dan menggunakan nama huruf drive dalam database nama persistennya.

Nama huruf drive harus menyertakan jalur lengkap tautan simbolis dalam namespace objek dan harus memiliki sintaks MS-DOS tradisional. Misalnya, huruf kandar "D" harus diwakili dengan cara ini: "\DosDevices\D:". Jalur tautan simbolis alternatif "?? \D:" tidak dapat digunakan, atau mungkin singkatan dari tautan simbolis seperti "D:".

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer output

Driver klien harus menempatkan struktur panjang variabel jenis MOUNTDEV_SUGGESTED_LINK_NAME, yang ditentukan dalam moundev.h, di awal buffer di Irp-AssociatedIrp.SystemBuffer>. Mulai dari alamat nama anggota struktur, driver klien harus menyisipkan nama persisten yang disarankan.

Panjang buffer output

Parameters.DeviceIoControl.OutputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer output, yang harus lebih besar dari atau sama dengan sizeof(MOUNTDEV_SUGGESTED_LINK_NAME).

Blok status

Jika operasi berhasil, bidang Informasi diatur ke jumlah total byte yang dikembalikan dan bidang Status diatur ke STATUS_SUCCESS.

Jika OutputBufferLength kurang dari sizeof(MOUNTDEV_SUGGESTED_LINK_NAME), bidang Status diatur ke STATUS_INVALID_PARAMETER.

Jika OutputBufferLength kurang dari panjang total data output, bidang Status diatur ke STATUS_BUFFER_OVERFLOW dan bidang Informasi diatur ke sizeof(MOUNTDEV_SUGGESTED_LINK_NAME).

Keterangan

Pelaksana fungsi ini tidak boleh menyinkronkan utas dan tidak boleh melakukan pemblokiran dan/atau panggilan fungsi Interprocess Communication (IPC).

Persyaratan

Persyaratan Nilai
Header mountdev.h (termasuk Mountdev.h)

Lihat juga

MOUNTDEV_SUGGESTED_LINK_NAME