다음을 통해 공유


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 함수를 사용합니다.

설명

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

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

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

기술 지원 여부
SMB(서버 메시지 블록) 3.0 프로토콜 No
SMB 3.0 TFO(투명 장애 조치(failover)) No
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 No
CsvFS(클러스터 공유 볼륨 파일 시스템) Yes
ReFS(Resilient File System) Yes
 

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

예제

예제는 파일 핸들에서 파일 이름 가져오기를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 fileapi.h(Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

볼륨 관리 함수