FilterGetDosName 함수(fltuser.h)

아티클
02/26/2024

FilterGetDosName 함수는 지정된 볼륨 이름에 해당하는 MS-DOS 디바이스 이름을 반환합니다.

구문

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

매개 변수

[in] lpVolumeName

볼륨 이름을 포함하는 NULL로 끝나는 와이드 문자열에 대한 포인터입니다.

lpVolumeName 입력 문자열은 다음 중 한 개일 수 있습니다. 후행 백슬래시(\)는 선택 사항입니다.

드라이브 문자(예: "D:\"
볼륨 탑재 지점의 경로(예: "c:\mnt\edrive\"
고유한 볼륨 식별자( 볼륨 GUID 이름이라고도 함)(예: "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
"\Device\HarddiskVolume1\"과 같은 존재하지 않는 디바이스 이름(대상 이름 또는 NT 디바이스 이름이라고도 함)입니다.

이 매개 변수는 필수이며 NULL일 수 없습니다.

[out] lpDosName

MS-DOS 디바이스 이름을 NULL로 끝나는 와이드 문자 문자열로 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다.

[in] dwDosNameBufferSize

lpDosName 이 가리키는 버퍼의 크기(와이드 문자)입니다.

반환 값

FilterGetDosName은 성공하면 S_OK 반환합니다. 그렇지 않으면 오류 값이 반환됩니다.

설명

FilterGetDosName 은 볼륨의 드라이브 문자가 있는 경우 해당 볼륨의 드라이브 문자를 반환합니다. 볼륨에 드라이브 문자가 할당되지 않은 경우 FilterGetDosName 은 볼륨 탑재 지점( 탑재 지점 이름이라고도 함)에 대한 경로를 반환합니다. 볼륨에 대해 드라이브 문자 또는 탑재 지점이 정의되지 않은 경우 FilterGetDosName 은 S_OK 반환하고 lpDosName 은 NULL을 받습니다.