PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 콜백 함수(netfw.h)

동적 키워드(keyword) 주소를 입력 ID로 업데이트하기 위해 호출하는 서비스의 진입점의 함수 포인터 형식입니다.

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

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

구문

PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;

DWORD PfnFwupdatedynamickeywordaddress0(
  GUID dynamicKeywordAddressId,
  PCWSTR updatedAddresses,
  BOOL append
)
{...}

매개 변수

dynamicKeywordAddressId

형식: GUID

업데이트할 동적 키워드(keyword) 주소 개체의 ID입니다.

updatedAddresses

형식: PCWSTR

개체를 업데이트할 IP 주소, 서브넷 또는 범위의 쉼표로 구분된 목록입니다.

append

형식: BOOL

TRUE로 설정하면 업데이트된Addresses가 개체의 현재 주소 목록에 추가됩니다. FALSE로 설정하면 업데이트된Addresses가 개체의 현재 주소 목록을 대체합니다.

반환 값

형식: DWORD

함수가 성공하면(개체가 성공적으로 업데이트됨) ERROR_SUCCESS 반환합니다. 그렇지 않으면 다음 값 중 하나를 반환합니다.

설명

추가가 TRUE이면 입력 주소가 개체의 현재 주소 목록에 추가됩니다. 입력 매개 변수가 개체에 이미 설정된 주소의 중복인 경우 삭제되고 ERROR_SUCCESS 반환됩니다.

방화벽 서비스는 주소가 동적 키워드(keyword) 주소의 기존 주소 필드 값과 정확히 동일한 경우 주소를 중복으로 처리합니다. 중복 값은 개별 요소별로 고려되므로 IP 주소 목록이 포함된 업데이트에는 중복 입력의 하위 집합만 삭제될 수 있습니다. 예를 들어 동적 키워드(keyword) 주소 개체에 가 포함된 127.0.0.0-127.0.0.255경우 또는 127.0.0.0/24 의 127.0.0.0-127.0.0.255 입력은 삭제됩니다. 그러나 와 같은 127.0.0.0-127.0.0.40 입력은 직접 중복이 아닌 하위 집합이므로 삭제되지 않습니다.

추가가 FALSE이면 개체의 현재 주소 목록을 입력으로 덮어씁니다.

MDM에서 시작된 AutoResolve가 아닌 개체는 ERROR_ACCESS_DENIED 발생합니다.

API 또는 PowerShell을 통해 로컬로 만든 AutoResolve가 아닌 개체는 이 API를 통해 업데이트됩니다.

원본의 AutoResolve 개체는 이 API를 통해 업데이트할 수 있습니다.

개체의 주소를 지우려면 updatedAddresses 값에 대해 NULL을 전달합니다.

updatedAddresses 매개 변수에 유효한 형식은 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)

요구 사항

추가 정보

• 방화벽 동적 키워드