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
반환 코드/값 | 설명 |
---|---|
|
TIA가 성공적으로 등록되었습니다. |
|
WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드를 참조하세요 . |
|
원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다. |
|
다른 TIA가 이미 키를 지시하도록 등록되었기 때문에 TIA가 성공적으로 등록되지 않았습니다. |
|
keyDictationTimeoutHint이 허용되는 최대값인 10초를 초과했기 때문에 TIA가 성공적으로 등록되지 않았습니다. |
|
이진 이미지가 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 |