getLogicalDriveStringsW 函式 (fileapi.h)

以指定系統中有效磁片磁碟機的字串填入緩衝區。

語法

DWORD GetLogicalDriveStringsW(
  [in]  DWORD  nBufferLength,
  [out] LPWSTR 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 不支援磁片區管理功能。