FwpmProviderAdd0 함수(fwpmk.h)

FwpmProviderAdd0 함수는 시스템에 새 공급자를 추가합니다.

통사론

NTSTATUS FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

매개 변수

[in] engineHandle

필터 엔진에 대한 열린 세션에 대한 핸들입니다. FwpmEngineOpen0 호출하여 필터 엔진에 대한 세션을 엽니다.

[in] provider

추가할 공급자 개체입니다.

[in, optional] sd

공급자 개체에 대한 보안 정보입니다.

반환 값

발언

호출자가 null 보안 설명자를 제공하는 경우 시스템은 기본 보안 설명자를 할당합니다.

부팅 시간 개체는 TCP/IP 드라이버가 시작될 때 BFE(기본 필터링 엔진)에 추가되고 BFE가 초기화를 마치면 제거됩니다. BFE가 시작될 때 영구 개체가 추가됩니다. 정책 공급자에 연결된 서비스가 사용하지 않도록 설정된 경우 적용할 수 없는 영구 정책이 있는 경우 호출자는 FWPM_PROVIDER0 구조에서 선택적 서비스 이름을 지정할 수 있습니다. 그런 다음 이 서비스는 영구 정책 개체를 소유합니다. 처음에 BFE는 시스템에 다음과 같은 유형의 영구 개체만 추가합니다.

• 개체가 공급자와 연결되어 있지 않습니다.
• 개체에는 서비스 이름을 지정하지 않는 연결된 공급자가 있습니다.
• 개체에 연결된 공급자와 연결된 서비스가 자동 시작되도록 설정되어 있습니다.

이 함수는 읽기 전용 트랜잭션 내에서 호출할 수 없으며 FWP_E_INCOMPATIBLE_TXN함께 실패합니다. 트랜잭션에 대한 자세한 내용은 개체 관리 참조하세요.

호출자는 공급자의 컨테이너에 FWPM_ACTRL_ADD 액세스해야 합니다. 자세한 내용은 Access Control 참조하세요.

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

요구 사항

참고 항목

• FwpmEngineOpen0
• FWPM_PROVIDER0
• FWPM_ACTRL_ADD
• WFP 오류 코드
• 개체 관리
• access Control
• WFP Version-Independent 이름 및 특정 버전의 Windows 대상으로 지정