TokenBindingVerifyMessage 함수(tokenbinding.h)

토큰 바인딩 메시지의 유효성을 검사하고 메시지에 포함된 토큰 바인딩을 확인합니다.

구문

SECURITY_STATUS TokenBindingVerifyMessage(
  [in]  const void                       *tokenBindingMessage,
  [in]  DWORD                            tokenBindingMessageSize,
  [in]  TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
  [in]  const void                       *tlsEKM,
  [in]  DWORD                            tlsEKMSize,
  [out] TOKENBINDING_RESULT_LIST         **resultList
);

매개 변수

[in] tokenBindingMessage

토큰 바인딩 메시지를 포함하는 버퍼에 대한 포인터입니다.

[in] tokenBindingMessageSize

tokenBindingMessage 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

[in] keyType

사용할 협상된 키 알고리즘입니다. TokenBindingGetKeyTypesServer 함수를 호출하여 검색한 키 형식 목록의 값을 사용합니다.

[in] tlsEKM

고유 데이터를 포함하는 버퍼에 대한 포인터입니다.

[in] tlsEKMSize

tlsUnique 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

[out] resultList

TokenBindingVerifyMessage가 확인하는 각 토큰 바인딩에 대한 결과를 포함하는 버퍼의 주소를 수신하는 포인터입니다.

사용자 모드에서 HeapAlloc 를 사용하여 버퍼에 대한 메모리를 할당하고 HeapFree 를 사용하여 해당 메모리를 해제합니다. 커널 모드에서 ExAllocatePoolWithTag 를 사용하여 버퍼에 대한 메모리를 할당하고 ExFreePool 을 사용하여 해당 메모리를 해제합니다.

반환 값

함수의 성공 또는 실패를 나타내는 상태 코드를 반환합니다.

설명

사용자 모드와 커널 모드 모두에서 TokenBindingVerifyMessage 를 호출할 수 있습니다. o 커널 모드에서 이 함수를 호출하고, Ksecdd.sys 연결하고, resultList 매개 변수에 대한 설명에 언급된 함수를 사용하여 메모리를 할당하고 해제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	tokenbinding.h
라이브러리	Tokenbinding.lib
DLL	Tokenbinding.dll(사용자 모드); Ksecdd.sys(커널 모드)

추가 정보

ExAllocatePoolWithTag

ExFreePool

TOKENBINDING_RESULT_LIST

TokenBindingGenerateMessage

TokenBindingGetKeyTypesServer