FilterVolumeFindNext 함수(fltuser.h)

아티클
03/09/2023

FilterVolumeFindNext 함수는 FilterVolumeFindFirst 호출로 시작된 볼륨 검색을 계속합니다.

구문

HRESULT FilterVolumeFindNext(
  [in]  HANDLE                          hVolumeFind,
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned
);

매개 변수

[in] hVolumeFind

FilterVolumeFindFirst에 대한 이전 호출에서 반환된 볼륨 검색 핸들입니다.

[in] dwInformationClass

요청된 정보 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
FilterVolumeBasicInformation	lpBuffer 매개 변수가 가리키는 버퍼는 볼륨에 대한 FILTER_VOLUME_BASIC_INFORMATION 구조를 받습니다.
FilterVolumeStandardInformation	lpBuffer 매개 변수가 가리키는 버퍼는 볼륨에 대한 FILTER_VOLUME_STANDARD_INFORMATION 구조를 받습니다. 이 구조는 Windows Vista부터 사용할 수 있습니다.

[out] lpBuffer

요청된 정보를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼에 반환된 정보의 형식은 dwInformationClass 매개 변수에 의해 정의됩니다.

[in] dwBufferSize

lpBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다. 호출자는 지정된 dwInformationClass에 따라 이 매개 변수를 설정해야 합니다.

[out] lpBytesReturned

FilterVolumeFindNext 호출이 성공하면 lpBuffer가 가리키는 버퍼에 반환된 바이트 수를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

FilterVolumeFindNext 는 볼륨 정보를 성공적으로 반환하는 경우 S_OK 반환합니다. 그렇지 않으면 다음 중 하나와 같은 HRESULT 오류 값을 반환합니다.

반환 코드	설명
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	lpBuffer가 가리키는 버퍼가 요청된 정보를 포함할 만큼 크지 않습니다. 이 값이 반환되면 lpBytesReturned 에는 지정된 dwInformationClass 구조에 필요한 버퍼의 크기(바이트)가 포함됩니다.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	dwInformationClass 매개 변수에 잘못된 값이 지정되었습니다. 예를 들어 Windows Vista 이전의 운영 체제에 대해 FilterVolumeStandardInformation 이 지정된 경우 FilterVolumeFindNext 는 이 HRESULT 값을 반환합니다.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	필터 관리자에 알려진 볼륨 목록에서 더 이상 볼륨을 찾을 수 없습니다.

설명

FilterVolumeFindFirst를 호출하여 검색 핸들을 설정한 후 FilterVolumeFindNext 함수를 사용하여 다른 볼륨을 검색합니다. FilterVolumeFindNext 는 호출당 하나의 볼륨을 찾습니다.

FilterVolumeFindFirst 및 FilterVolumeFindNext를 사용하여 필터 관리자에 알려진 볼륨 목록을 열거하는 경우 목록의 볼륨 중 두 개 이상이 같은 이름을 가질 수 있습니다. 자세한 내용은 중복 볼륨 이름을 사용하여 볼륨 열거형 이해를 참조하세요.