FwpmProviderAdd0 함수(fwpmu.h)

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

구문

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

매개 변수

[in] engineHandle

형식: HANDLE

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

[in] provider

형식: FWPM_PROVIDER0*

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

[in, optional] sd

형식: PSECURITY_DESCRIPTOR

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

반환 값

형식:DWORD

설명

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

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

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

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

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

요구 사항

추가 정보

FWPM_PROVIDER0