FilterGetDosName 函式 (fltuser.h)

發行項
02/29/2024

FilterGetDosName 函式會傳回對應至指定磁碟區名稱的 MS-DOS 裝置名稱。

語法

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

參數

[in] lpVolumeName

包含磁碟區名稱之 NULL 終止寬字元字串的指標。

lpVolumeName 輸入字串可以是下列任一項。尾端反斜杠 (\) 是選擇性的。

驅動器號，例如 “D：\”
磁碟區裝入點的路徑，例如 “c：\mnt\edrive\”
磁碟區標識碼 (也稱為磁碟區 GUID 名稱) ，例如 “\？？\Volume{7603f260-142a-11d4-ac67-806d6172696f}\”
非持續性裝置名稱 (也稱為 目標名稱 或 NT 裝置名稱) ，例如 “\Device\HarddiskVolume1\”

這個參數是必要的，而且不能是 NULL。

[out] lpDosName

呼叫端配置的緩衝區指標，接收 MS-DOS 裝置名稱做為 NULL 終止的寬字元字串。

[in] dwDosNameBufferSize

大小，以寬字元表示 lpDosName 指向的緩衝區。

傳回值

如果成功，FilterGetDosName 會傳回S_OK。否則，它會傳回錯誤值。

備註

FilterGetDosName 如果磁碟區有驅動器號，則會傳回磁碟區驅動器號。如果未將驅動器號指派給磁碟區， FilterGetDosName 會傳回磁碟區裝入點的路徑， (也稱為 裝入點名稱) 。如果未定義磁碟區的驅動器號或裝入點， FilterGetDosName 會傳回S_OK，而 lpDosName 會接收 NULL。