IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME IOCTL (mountdev.h)
IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME 可讓裝載管理員用戶端，例如裝置或磁碟區驅動程式，建議其相關聯磁碟區的驅動器號或連結名稱。
掛接管理員用戶端對此IOCTL的支援是選擇性的。
主要程序代碼
輸入緩衝區
無。
輸入緩衝區長度
無。
輸出緩衝區
用戶端驅動程序必須在 Irp-AssociatedIrp.SystemBuffer> 緩衝區開頭放置類型MOUNTDEV_SUGGESTED_LINK_NAME可變長度的結構。 用戶端驅動程序必須在這個 結構的 Name 成員所指向的位址插入建議的永續性名稱。
輸出緩衝區長度
IRP I/O 堆疊位置中的 Parameters.DeviceIoControl.OutputBufferLength 表示輸出緩衝區的大小，以位元組為單位，其必須大於或等於 sizeof(MOUNTDEV_SUGGESTED_LINK_NAME)。
輸入/輸出緩衝區
N/A
輸入/輸出緩衝區長度
N/A
狀態區塊
如果作業成功， [資訊 ] 字段會設定為傳回的位元組總數，而 [狀態 ] 位元位會設定為 [STATUS_SUCCESS]。
如果 OutputBufferLength 小於 sizeof (MOUNTDEV_SUGGESTED_LINK_NAME) ， [狀態] 字段會設定為 [STATUS_INVALID_PARAMETER]。
如果 OutputBufferLength 小於輸出數據的總長度， [狀態 ] 欄位會設定為 [STATUS_BUFFER_OVERFLOW]，而 [資訊 ] 字段會設定為 sizeof (MOUNTDEV_SUGGESTED_LINK_NAME) 。
備註
某些掛接管理員用戶端可以在系統重新啟動時追蹤其驅動器號，而不需要掛接管理員的協助。 這類用戶端可以將建議的驅動器號名稱傳送給掛接管理員，以回應此 IOCTL。 如果掛接管理員的資料庫尚未包含用戶端磁碟區的永續性驅動器號名稱，則掛接管理員會使用建議的名稱。 否則，它會忽略建議，並在其永續性名稱資料庫中使用驅動器號名稱。
驅動器號名稱必須包含物件命名空間中符號連結的完整路徑，而且必須具有傳統的 MS-DOS 語法。 例如，驅動器號 「D」 必須以此方式表示：「\DosDevices\D：“。 “？？ 的替代符號鏈接路徑無法使用 \D：“，也無法使用符號鏈接的縮寫，例如 ”D：“。
此函式的實作者不得線程同步處理，且不得進行封鎖和/或進程間通訊 (IPC) 函數調用。
如需詳細資訊，請參閱 支援記憶體類別驅動程式中的掛接管理員要求。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | mountdev.h (包含 Mountdev.h) |