FilterAttach 함수(fltuser.h)
FilterAttach 함수는 지정된 볼륨에 새 미니필터 instance 연결합니다.
구문
HRESULT FilterAttach(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[in, optional] DWORD dwCreatedInstanceNameLength,
[out, optional] LPWSTR lpCreatedInstanceName
);
매개 변수
[in] lpFilterName
instance 만들 미니필터의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
[in] lpVolumeName
새로 만든 instance 연결할 볼륨의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.
lpVolumeName 입력 문자열은 다음 중 어느 것일 수 있습니다. 후행 백슬래시(\)는 선택 사항입니다.
- 드라이브 문자(예: "D:\"
- 볼륨 탑재 지점의 경로(예: "c:\mnt\edrive\"
- 고유한 볼륨 식별자( 볼륨 GUID 이름이라고도 함)(예: "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- "\Device\HarddiskVolume1\"과 같이 존재하지 않는 디바이스 이름(대상 이름 또는 NT 디바이스 이름이라고도 함)입니다.
[in, optional] lpInstanceName
새 instance 대한 instance 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수가 NULL이면 새 instance FltAttachVolume에 대한 설명 섹션에 설명된 대로 미니필터의 기본 instance 이름을 받습니다.
[in, optional] dwCreatedInstanceNameLength
lpCreatedInstanceName 이 가리키는 버퍼의 길이(바이트)입니다. 이 매개 변수는 선택 사항이며 0일 수 있습니다.
[out, optional] lpCreatedInstanceName
instance 볼륨에 성공적으로 연결된 경우 새 instance 대한 instance 이름을 수신하는 호출자가 할당한 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. NULL이 아닌 경우 버퍼는 INSTANCE_NAME_MAX_CHARS 문자와 NULL 종결자를 포함할 수 있을 만큼 커야 합니다.
반환 값
FilterAttach는 성공하면 S_OK 반환합니다. 그렇지 않으면 다음 중 하나와 같은 오류 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
지정된 볼륨의 이 고도에 이미 instance 있습니다. |
|
지정된 볼륨에 이 이름을 가진 instance 이미 있습니다. |
|
lpInstanceName이 NULL이 아닌 경우 lpInstanceName은 레지스트리의 등록된 필터 instance 이름과 일치하지 않습니다. |
설명
FilterAttach 는 FltAttachVolume에 해당하는 Win32입니다.
lpInstanceName에 지정된 instance 이름은 시스템 전체에서 고유해야 합니다.
지정된 고도의 볼륨에 미니필터 instance 연결하려면 FilterAttachAtAltitude를 호출합니다.
볼륨에서 미니 필터 instance 분리하려면 FilterDetach를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | fltuser.h(Fltuser.h 포함) |
| 라이브러리 | FltLib.lib |
| DLL | FltLib.dll |