FwpmDynamicKeywordSubscribe0 함수(fwpmu.h)

  • 아티클

특정 동적 키워드(keyword) 주소(FW_DYNAMIC_KEYWORD_ADDRESS0) 개체의 변경 내용에 대한 알림 배달을 요청합니다. 전달된 플래그에 따라 주소의 하위 집합에 대해서만 알림을 발생할 수 있습니다.

자세한 정보 및 코드 예제는 방화벽 동적 키워드를 참조하세요.

구문

DWORD FwpmDynamicKeywordSubscribe0(
  DWORD                          flags,
  FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
  void                           *context,
  HANDLE                         *subscriptionHandle
);

매개 변수

flags

형식: _In_ DWORD

다음 플래그는 에 정의되어 있습니다 fwpmu.h.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVEFW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 플래그가 설정된 개체에 대해서만 알림이 전달됨을 나타냅니다.

FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVEFW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 플래그가 설정되지 않은 개체에 대해서만 알림이 전달됨을 나타냅니다.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE모든 동적 키워드(keyword) 주소 개체에 대한 알림이 전달됨을 나타냅니다.

callback

형식: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0

알림이 배달 준비가 되면 호출되는 구현하는 콜백 함수에 대한 포인터입니다.

context

형식: _In_opt_ void*

선택적 컨텍스트 포인터입니다. 이 포인터는 콜백 함수에 전달됩니다.

subscriptionHandle

형식: _Out_ HANDLE*

새로 만든 구독에 대한 핸들로 채워진 핸들의 주소입니다.

반환 값

형식: DWORD

함수가 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 다음 값 중 하나를 반환합니다.

반환 값 Description
ERROR_INVALID_PARAMETER flags 값은 0입니다.

설명

AutoResolve 동적 키워드(keyword) 주소에 대한 알림은 개체가 추가되거나 삭제될 때 전달됩니다.

비 AutoResolve 동적 키워드(keyword) 주소에 대한 알림은 개체가 추가, 삭제 또는 업데이트될 때 전달됩니다.

콜백 함수에 데이터가 제공되지 않습니다. 시스템에서 변경된 내용에 대한 정보가 필요한 경우 열거형 API를 사용할 수 있습니다.

구독이 더 이상 필요하지 않은 경우 핸들을 닫을 책임이 있습니다. 이렇게 하려면 FwpmDynamicKeywordUnsubscribe0 함수를 호출해야 합니다.

FWPM_DYNAMIC_KEYWORD_CALLBACK0 구현은 ThreadPool 스레드에서 예약되고 다른 대기 작업에 영향을 줄 수 있으므로 동적 키워드(keyword) 주소 개체의 변경에 신속하게 대응해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 빌드 20348
지원되는 최소 서버 Windows 10 빌드 20348
대상 플랫폼 Windows
헤더 fwpmu.h
라이브러리 Fwpuclnt.lib
DLL Fwpuclnt.dll

추가 정보