SetContextAttributesA 함수(sspi.h)
전송 애플리케이션이 보안 패키지에 대한 보안 컨텍스트의 특성을 설정할 수 있도록 합니다. 이 함수는 Schannel 보안 패키지에서만 지원됩니다.
구문
SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[in] void *pBuffer,
[in] unsigned long cbBuffer
);
매개 변수
[in] phContext
설정할 보안 컨텍스트에 대한 핸들입니다.
[in] ulAttribute
설정할 컨텍스트의 특성입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
pBuffer 매개 변수는 SecPkgContext_SessionAppData 구조체에 대한 포인터를 포함합니다.
세션에 대한 애플리케이션 데이터를 설정합니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_EapPrfInfo 구조체에 대한 포인터를 포함합니다.
EAP(확장 가능 인증 프로토콜)에서 사용하는 PRF(의사 임의 함수)를 설정합니다. 이는 SECPKG_ATTR_EAP_KEY_BLOCKulAttribute 매개 변수의 값으로 전달될 때 QueryContextAttributes(Schannel) 함수를 호출하여 반환되는 값입니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_EarlyStart 구조체에 대한 포인터를 포함합니다.
False Start 기능을 설정합니다. 이 기능에 대한 자세한 내용은 더 빠르고 안전한 웹 블로그 게시물 빌드를 참조하세요. |
|
DTLS에 사용할 MTU(최대 전송 단위) 값을 설정하고 검색합니다.
보안 컨텍스트에서 DTLS를 사용하도록 설정하지 않은 경우 이 특성은 지원되지 않습니다.
유효한 값은 200바이트에서 64킬로바이트 사이입니다. Schannel의 기본 DTLS MTU 값은 1096바이트입니다. |
|
pBuffer 매개 변수는 SecPkgContext_KeyingMaterialInfo 구조체에 대한 포인터를 포함합니다. 키링 재질 내보내기 기능은 RFC 5705 표준을 따릅니다.
이 특성은 Windows 10 및 Windows Server 2016 이상 버전의 Schannel 보안 패키지에서만 지원됩니다. |
[in] pBuffer
특성을 설정할 값이 포함된 구조체에 대한 포인터입니다. 가리키는 구조체의 형식은 ulAttribute 매개 변수에 지정된 값에 따라 달라집니다.
[in] cbBuffer
pBuffer 매개 변수의 크기(바이트)입니다.
반환 값
함수가 성공하면 함수는 SEC_E_OK 반환합니다.
함수가 실패하면 0이 아닌 오류 코드가 반환됩니다. 다음 오류 코드는 가능한 오류 코드 중 하나입니다.
| 반환 코드 | 설명 |
|---|---|
|
이 값은 이 함수가 지원되지 않음을 나타내기 위해 Schannel 커널 모드에서 반환됩니다. |
설명
참고
sspi.h 헤더는 SETContextAttributes를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | sspi.h(Security.h 포함) |
| 라이브러리 | Secur32.lib |
| DLL | Secur32.dll |