다음을 통해 공유

IPsecKeyManagerAddAndRegister0 함수(fwpmu.h)

  • 아티클

IPsecKeyManagerAddAndRegister0 함수는 IPsec에 TIA(신뢰할 수 있는 중간 에이전트)를 등록합니다.

구문

DWORD IPsecKeyManagerAddAndRegister0(
  [in]  HANDLE                             engineHandle,
  [in]  const IPSEC_KEY_MANAGER0           *keyManager,
  [in]  const IPSEC_KEY_MANAGER_CALLBACKS0 *keyManagerCallbacks,
  [out] HANDLE                             *keyMgmtHandle
);

매개 변수

[in] engineHandle

형식: HANDLE

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

[in] keyManager

형식: const IPSEC_KEY_MANAGER0*

IPsec이 호출할 키 관리 콜백 집합입니다.

[in] keyManagerCallbacks

형식: const IPSEC_KEY_MANAGER_CALLBACKS0*

SA 협상의 다양한 단계에서 IPsec에서 호출해야 하는 콜백 집합입니다.

[out] keyMgmtHandle

형식: HANDLE*

새로 만든 등록의 주소입니다.

반환 값

형식:DWORD

반환 코드/값 설명
ERROR_SUCCESS
0
 TIA가 성공적으로 등록되었습니다.
FWP_E_* 오류 코드
0x80320001— 0x80320039
 WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드를 참조하세요 .
RPC_* 오류 코드
0x80010001— 0x80010122
 원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다.
FWP_E_ALREADY_EXISTS
0x80320009L
 다른 TIA가 이미 키를 지시하도록 등록되었기 때문에 TIA가 성공적으로 등록되지 않았습니다.
FWP_E_INVALID_INTERVAL
0x80320021L
 keyDictationTimeoutHint이 허용되는 최대값인 10초를 초과했기 때문에 TIA가 성공적으로 등록되지 않았습니다.
SEC_E_CANNOT_INSTALL
0x80090307L
 이진 이미지가 IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY 속성을 설정하지 않았기 때문에 TIA가 성공적으로 등록되지 않았습니다.

설명

keyManager에 대해 IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY 플래그를 설정한 경우 keyManagerCallbacks의 세 콜백 멤버를 모두 지정해야 합니다. 그렇지 않으면 keyNotify 콜백만 지정해야 합니다.

이 함수는 트랜잭션 내에서 호출할 수 없습니다. FWP_E_TXN_IN_PROGRESS 실패합니다. 트랜잭션에 대한 자세한 내용은 개체 관리를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 fwpmu.h
라이브러리 Fwpuclnt.lib
DLL Fwpuclnt.dll

추가 정보

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

WFP 함수