FwpmEngineOpen0 함수(fwpmk.h)

아티클
08/07/2023

FwpmEngineOpen0 함수는 필터 엔진에 대한 세션을 엽니다.

참고

FwpmEngineOpen0 은 FwpmEngineOpen의 특정 버전입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.

구문

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

매개 변수

[in, optional] serverName

필터 엔진에 대한 세션이 열리는 시스템의 표준 DNS 이름을 지정하는 NULL로 끝나는 문자열에 대한 포인터입니다. 콜아웃 드라이버는 이 매개 변수에 대해 NULL 을 지정해야 합니다.

[in] authnService

사용할 인증 서비스입니다. 이 매개 변수에 대한 유효한 선택 항목 목록은 Microsoft Windows SDK 설명서의 RPC 섹션에 있는 Authentication-Service 상수를 참조하세요. 콜아웃 드라이버는 이 매개 변수에 대해 RPC_C_AUTHN_WINNT 또는 RPC_C_AUTHN_DEFAULT 지정해야 합니다.

[in, optional] authIdentity

필터 엔진에 액세스하기 위한 인증 및 권한 부여 자격 증명을 포함하는 SEC_WINNT_AUTH_IDENTITY_W 구조에 대한 포인터입니다. 이 매개 변수는 FwpmEngineOpen0 함수가 콜아웃 드라이버에서 호출될 때 무시됩니다. 콜아웃 드라이버는 이 매개 변수를 NULL로 설정해야 합니다.

[in, optional] session

열려는 세션에 대한 세션별 매개 변수를 정의하는 FWPM_SESSION0 구조체에 대한 포인터입니다. 이 포인터는 선택 사항이며 NULL일 수 있습니다.

[out] engineHandle

필터 엔진에 열려 있는 세션에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

반환 값

FwpmEngineOpen0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	필터 엔진에 대한 세션이 성공적으로 열렸습니다. engineHandle 매개 변수가 가리키는 변수에는 열린 세션에 대한 핸들이 포함됩니다.
기타 상태 코드	오류가 발생했습니다.

설명

콜아웃 드라이버는 FwpmEngineOpen0 함수를 호출하여 필터 엔진에 대한 세션을 엽니다. 필터 엔진에 대한 열린 세션에 대한 핸들은 대부분의 Windows 필터링 플랫폼 관리 기능에 필요한 매개 변수입니다.

설명선 드라이버는 일반적으로 Windows 필터링 플랫폼 관리 함수를 호출하지 않으므로 일반적으로 필터 엔진에 대한 세션을 열 필요가 없습니다.

콜아웃 드라이버가 필터 엔진에 대한 세션을 성공적으로 열려면 콜아웃 드라이버가 FwpmEngineOpen0 함수를 호출할 때 필터 엔진이 현재 실행 중이어야 합니다. 콜아웃 드라이버는 FwpmBfeStateGet0 함수를 호출하여 필터 엔진의 현재 상태를 가져올 수 있습니다. FwpmBfeStateGet0을 호출하기 전에 설명선 드라이버는 FwpmBfeStateSubscribeChanges0 함수를 호출하여 필터 엔진 상태가 변경될 때마다 호출될 콜백 함수를 등록해야 합니다.

콜아웃 드라이버가 필터 엔진에 대한 액세스를 완료한 후 FwpmEngineClose0 함수를 호출하여 열려 있는 세션을 필터 엔진에 닫습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	fwpmk.h(Fwpmk.h 포함)
라이브러리	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL