getLogicalDriveStringsA 函式 (winbase.h)

以指定系統中有效磁碟驅動器的字串填入緩衝區。

語法

DWORD GetLogicalDriveStringsA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

[in] nBufferLength

TCHAR 中 lpBuffer 指向的緩衝區大小上限。此大小不包含終止的 Null 字元。如果此參數為零，則不會使用 lpBuffer 。

[out] lpBuffer

緩衝區的指標，接收一系列以 Null 終止的字串，一個用於系統中每個有效磁碟驅動器，再加上額外的 Null 字元。每個字串都是裝置名稱。

如果函式成功，傳回值會是複製到緩衝區之字串的長度，以字元為單位，不包含終止的 Null 字元。請注意，ANSI-ASCII Null 字元使用一個字節，但 Unicode (UTF-16) Null 字元會使用兩個字節。

如果緩衝區不夠大，傳回值就會大於 nBufferLength。這是保存磁碟驅動器字串所需的緩衝區大小。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請使用 GetLastError 函式。

每當需要根目錄時，都可以使用緩衝區中的每個字串，例如 GetDriveType 和 GetDiskFreeSpace 函式。

此函式會傳回全域和本機 MS-DOS 裝置命名空間中磁碟驅動器的串連。如果這兩個命名空間中有磁碟驅動器，此函式會傳回本機 MS-DOS 裝置命名空間中的專案。如需詳細資訊，請參閱定義 MS DOS 裝置名稱。

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

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

如需範例，請參閱從檔句柄取得檔名。