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는 볼륨 관리 기능을 지원하지 않습니다.

예를 들어 파일 핸들파일 이름 가져오기 참조하세요.

GetLogicalDrives

이 페이지가 도움이 되었나요?