ApplyControlToken 함수(sspi.h)

아티클
08/26/2023

ApplyControlToken 함수는 보안 컨텍스트에 컨트롤 토큰을 적용하는 방법을 제공합니다. InitializeSecurityContext(Schannel) 함수를 호출하거나 메시지별 보안 서비스(예: 확인 또는 봉인 해제)를 사용하여 보안 컨텍스트를 설정할 때 토큰을 받을 수 있습니다.

이 함수는 SSP(Schannel 보안 지원 공급자 )에서만 지원됩니다.

이 함수는 커널 모드에서 지원되지 않습니다.

이 함수를 사용하면 컨텍스트에 추가 또는 대체 토큰을 적용할 수 있습니다.

구문

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

매개 변수

[in] phContext

토큰이 적용되는 컨텍스트에 대한 핸들입니다.

Schannel SSP가 종료의 원격 당사자에게 알리는 방법에 대한 자세한 내용은 DecryptMessage(Schannel)의 설명 섹션을 참조하세요. 이 함수 사용에 대한 자세한 내용은 Schannel 연결 종료를 참조하세요.

[in] pInput

컨텍스트에 적용할 입력 토큰이 포함된 SecBuffer 구조체에 대한 포인터를 포함하는 SecBufferDesc 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 SEC_E_OK 반환합니다.

함수가 실패하면 0이 아닌 오류 코드가 반환됩니다. 다음 오류 코드는 반환할 수 있는 가능한 오류 코드 중 하나입니다.

반환 코드	설명
SEC_E_UNSUPPORTED_FUNCTION	이 값은 이 함수가 지원되지 않음을 나타내기 위해 Schannel 커널 모드에서 반환됩니다.

설명

ApplyControlToken 함수는 이 토큰에 따라 컨텍스트를 수정할 수 있습니다. 이 함수가 클라이언트 컨텍스트에 추가할 수 있는 토큰 중에는 SCHANNEL_ALERT_TOKEN 및 SCHANNEL_SESSION_TOKEN 있습니다.

이 함수는 기존 Schannel 연결의 기반이 되는 보안 컨텍스트 를 종료하는 데 사용할 수 있습니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 Schannel 연결 종료를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	sspi.h(Security.h 포함)
라이브러리	Secur32.lib
DLL	Secur32.dll