GetVolumePathNamesForVolumeNameW 函式 (fileapi.h)

  • 發行項

擷取指定磁碟區驅動器號和掛接的資料夾路徑清單。

語法

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

參數

[in] lpszVolumeName

磁碟區的磁碟區 GUID 路徑。 磁碟區 GUID 路徑的格式為 “\\？\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx}\”。

[out] lpszVolumePathNames

緩衝區的指標，接收驅動器號和掛接的資料夾路徑清單。 此清單是以 Null 結尾字串的陣列，以其他 NULL 字元結尾。 如果緩衝區不夠大，無法保存完整清單，則緩衝區會盡可能保留大部分的清單。

[in] cchBufferLength

TCHAR 中 lpszVolumePathNames 緩衝區的長度，包括所有 NULL 字元。

[out] lpcchReturnLength

如果呼叫成功，此參數是複製到 lpszVolumePathNames 緩衝區的 TCHA 數目。 否則，此參數是 TCHAR 中保存完整清單所需的緩衝區大小。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 如果緩衝區不夠大，無法保存完整清單，錯誤碼會ERROR_MORE_DATA，而 lpcchReturnLength 參數會收到所需的緩衝區大小。

備註

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes
 

SMB 不支援磁碟區管理功能。

範例

如需範例，請參閱 顯示磁碟區路徑。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 fileapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

掛接的資料夾

磁碟區管理功能