PFN_FWADDDYNAMICKEYWORDADDRESS0 콜백 함수(netfw.h)

지정된 동적 키워드(keyword) 주소를 추가하기 위해 호출하는 서비스의 진입점의 함수 포인터 형식입니다.

참고

이 무료 함수에 대한 포인터 형식은 를 통해 NetFw.h게시되지만 정적 링크 라이브러리는 게시되지 않습니다. 이 함수를 호출 하려면 LoadLibraryExW/GetProcAddress 패턴을 사용합니다.

GetProcAddress를 호출할 때 firewallapi.dll 모듈에 핸들을 전달하고 FWAddDynamicKeywordAddress0을 lpProcName 인수로 전달합니다.

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

구문

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

DWORD PfnFwadddynamickeywordaddress0(
  const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}

매개 변수

dynamicKeywordAddress

형식: const PFW_DYNAMIC_KEYWORD_ADDRESS0

상수(채워진) 동적 키워드(keyword) 주소 개체에 대한 포인터입니다.

반환 값

형식: DWORD

함수가 성공하면(개체가 성공적으로 만들어지고 추가됨) ERROR_SUCCESS 반환합니다. 그렇지 않으면 다음 값 중 하나를 반환합니다.

반환 값	설명
ERROR_ACCESS_DENIED	호출자에게 이 개체를 만들 수 있는 적절한 권한이 없습니다.
ERROR_ALREADY_EXISTS	지정된 ID를 가진 개체가 시스템에 이미 있습니다.
ERROR_INVALID_PARAMETER	잘못된 FW_DYNAMIC_KEYWORD_ADDRESS0. 유효한 사용 법은 비고를 참조하세요.

설명

• FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 플래그가 설정된 경우 다음을 수행합니다.
  • 주소는 NULL이어야 하며,
  • 키워드(keyword) 필드는 확인할 수 있는 문자열, 즉 FQDN 또는 호스트 이름이어야 합니다.
• FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 플래그가 설정되지 않은 경우 주소 필드는 쉼표로 구분된 IP 주소 토큰 목록이어야 합니다. 토큰은 개별 IP 주소, 범위 또는 서브넷일 수 있습니다. 유효한 토큰 형식은 다음과 같습니다.
  • 유효한 IPv4 주소(예: 10.0.0.10)
  • 유효한 IPv6 주소(예: 2620:1ec:c11::200)
  • 공백이 포함되지 않은 시작 주소>< 끝 주소 형식<의 IPv4 주소> 범위(예: 10.0.0.0-10.0.0.255)
  • 공백이 포함되지 않은 시작 주소>< 끝 주소> 형식<의 IPv6 주소 범위(예: 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff)
  • 네트워크 접두사 표기법을 사용하여 지정된 유효한 IPv4 서브넷(예: 10.0.0.0/24)
  • 접두사 길이 표기법을 사용하여 지정된 유효한 IPv6 서브넷(예: 2001:db8:abcd:0012::0/64)
• 동적 키워드(keyword) 주소는 다시 부팅할 때 유지됩니다. AutoResolved 개체의 경우 주소는 부팅 주기에 걸쳐 유지되지 않으며 다음 부팅 주기 동안 다시 평가되어야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 10 빌드 20348
지원되는 최소 서버	Windows 10 빌드 20348
대상 플랫폼	Windows
헤더	netfw.h
DLL	firewallapi.dll

추가 정보

• 방화벽 동적 키워드