GetVolumePathNamesForVolumeNameA 函式 (winbase.h)

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

語法

BOOL GetVolumePathNamesForVolumeNameA(
  [in]  LPCSTR lpszVolumeName,
  [out] LPCH   lpszVolumePathNames,
  [in]  DWORD  cchBufferLength,
  [out] PDWORD lpcchReturnLength
);

參數

[in] lpszVolumeName

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

[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 不支援磁碟區管理功能。

範例

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

規格需求

另請參閱

掛接的資料夾

磁碟區管理功能