SetContextAttributesW 함수(sspi.h)

전송 애플리케이션이 보안 패키지에 대한 보안 컨텍스트의 특성을 설정할 수 있도록 합니다. 이 함수는 Schannel 보안 패키지에서만 지원됩니다.

구문

SECURITY_STATUS SEC_ENTRY SetContextAttributesW(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

매개 변수

[in] phContext

설정할 보안 컨텍스트에 대한 핸들입니다.

[in] ulAttribute

설정할 컨텍스트의 특성입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
SECPKG_ATTR_APP_DATA 94	pBuffer 매개 변수는 SecPkgContext_SessionAppData 구조체에 대한 포인터를 포함합니다. 세션에 대한 애플리케이션 데이터를 설정합니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다.
SECPKG_ATTR_EAP_PRF_INFO 101	pBuffer 매개 변수는 SecPkgContext_EapPrfInfo 구조체에 대한 포인터를 포함합니다. EAP(확장 가능 인증 프로토콜)에서 사용하는 PRF(의사 임의 함수)를 설정합니다. 이는 SECPKG_ATTR_EAP_KEY_BLOCKulAttribute 매개 변수의 값으로 전달될 때 QueryContextAttributes(Schannel) 함수를 호출하여 반환되는 값입니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다.
SECPKG_ATTR_EARLY_START 105	pBuffer 매개 변수는 SecPkgContext_EarlyStart 구조체에 대한 포인터를 포함합니다. False Start 기능을 설정합니다. 이 기능에 대한 자세한 내용은 더 빠르고 안전한 웹 블로그 게시물 빌드를 참조하세요.
SECPKG_ATTR_DTLS_MTU 34	DTLS에 사용할 MTU(최대 전송 단위) 값을 설정하고 검색합니다. 보안 컨텍스트에서 DTLS를 사용하도록 설정하지 않은 경우 이 특성은 지원되지 않습니다. 유효한 값은 200바이트에서 64킬로바이트 사이입니다. Schannel의 기본 DTLS MTU 값은 1096바이트입니다.
SECPKG_ATTR_KEYING_MATERIAL_INFO 106	pBuffer 매개 변수는 SecPkgContext_KeyingMaterialInfo 구조체에 대한 포인터를 포함합니다. 키링 재질 내보내기 기능은 RFC 5705 표준을 따릅니다. 이 특성은 Windows 10 및 Windows Server 2016 이상 버전의 Schannel 보안 패키지에서만 지원됩니다.

[in] pBuffer

특성을 설정할 값이 포함된 구조체에 대한 포인터입니다. 가리키는 구조체의 형식은 ulAttribute 매개 변수에 지정된 값에 따라 달라집니다.

[in] cbBuffer

pBuffer 매개 변수의 크기(바이트)입니다.

반환 값

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

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

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

설명

참고

sspi.h 헤더는 SETContextAttributes를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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