GetLogicalDriveStringsW 함수(fileapi.h)

버퍼를 시스템에서 유효한 드라이브를 지정하는 문자열로 채웁니다.

구문

DWORD GetLogicalDriveStringsW(
  [in]  DWORD  nBufferLength,
  [out] LPWSTR lpBuffer
);

[in] nBufferLength

lpBuffer가 가리키는 버퍼의 최대 크기(TCHAR)입니다. 이 크기에는 종료 null 문자가 포함되지 않습니다. 이 매개 변수가 0이면 lpBuffer 가 사용되지 않습니다.

[out] lpBuffer

시스템의 유효한 각 드라이브에 대해 하나씩 일련의 null로 끝나는 문자열과 추가 null 문자를 받는 버퍼에 대한 포인터입니다. 각 문자열은 디바이스 이름입니다.

함수가 성공하면 반환 값은 종료 null 문자를 포함하지 않고 버퍼에 복사된 문자열의 길이(문자)입니다. ANSI-ASCII null 문자는 1바이트만 사용하지만 유니코드(UTF-16) null 문자는 2바이트를 사용합니다.

버퍼가 충분히 크지 않으면 반환 값이 nBufferLength보다 큽니다. 드라이브 문자열을 보유하는 데 필요한 버퍼의 크기입니다.

함수가 실패하면 반환 값은 0입니다. 확장된 오류 정보를 얻으려면 GetLastError 함수를 사용합니다.

GetDriveType 및 GetDiskFreeSpace 함수와 같이 루트 디렉터리가 필요한 위치에 버퍼의 각 문자열을 사용할 수 있습니다.

이 함수는 전역 및 로컬 MS-DOS 디바이스 네임스페이스에서 드라이브의 연결을 반환합니다. 드라이브가 두 네임스페이스에 있는 경우 이 함수는 로컬 MS-DOS 디바이스 네임스페이스에 항목을 반환합니다. 자세한 내용은 MS DOS 디바이스 이름 정의를 참조하세요.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

SMB는 볼륨 관리 기능을 지원하지 않습니다.