다음을 통해 공유

SaslSetContextOption 함수(sspi.h)

  • 아티클

SaslSetContextOption 함수는 지정된 SASL 컨텍스트에 대해 지정된 속성의 값을 설정합니다.

구문

SECURITY_STATUS SEC_ENTRY SaslSetContextOption(
  [in] PCtxtHandle ContextHandle,
  [in] ULONG       Option,
  [in] PVOID       Value,
  [in] ULONG       Size
);

매개 변수

[in] ContextHandle

SASL 컨텍스트의 핸들입니다.

[in] Option

SASL 컨텍스트에 대해 설정할 속성입니다. 다음 표에서 가능한 값을 나열합니다.

값 의미
SASL_OPTION_AUTHZ_PROCESSING
 버퍼의 데이터 형식: ULONG

SASL 애플리케이션에서 제공하는 Authz 값의 SASL 처리 상태입니다. 처리에 유효한 상태는 Sasl_AuthZIDForbidden Sasl_AuthZIDProcessed. 기본값은 Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING
 버퍼의 데이터 형식: 이진 문자 배열

SASL 클라이언트에서 서버로 전달되는 문자 문자열입니다. AuthZ_Processing 상태가 Sasl_AuthZIDForbidden 경우 SEC_E_UNSUPPORTED_FUNCTION 반환 값이 반환됩니다.
SASL_OPTION_RECV_SIZE
 버퍼의 데이터 형식: ULONG

로컬 컴퓨터에서 받는 버퍼의 최대 크기입니다. 기본값은 0x0FFFF 바이트입니다.
SASL_OPTION_SEND_SIZE
 버퍼의 데이터 형식: ULONG

전송할 수 있는 최대 메시지 데이터 크기입니다. 이 값은 블록 크기, 트레일러 크기 및 최대 서명 크기를 뺀 원격 SASL 프로세스로 전송할 수 있는 최대 버퍼 크기입니다. 기본값은 0x0FFFF 바이트입니다.

[in] Value

요청된 속성으로 설정할 값을 포함하는 버퍼에 대한 포인터입니다. Option 매개 변수의 각 값에 대한 버퍼의 데이터 형식은 Option 매개 변수를 참조하세요.

[in] Size

Value 매개 변수로 지정된 버퍼의 크기(바이트)입니다.

반환 값

호출이 성공적으로 완료되면 이 함수는 SEC_E_OK 반환합니다. 다음 표에는 몇 가지 가능한 오류 반환 값이 나와 있습니다.

반환 코드 설명
SEC_E_BUFFER_TOO_SMALL
 Value 매개 변수로 지정된 버퍼가 Option 매개 변수로 지정된 속성의 데이터 값을 포함할 만큼 크지 않습니다.
SEC_E_INVALID_HANDLE
 ContextHandle 매개 변수로 지정된 SASL 컨텍스트 핸들을 SASL 목록에서 찾을 수 없습니다.
SEC_E_UNSUPPORTED_FUNCTION
 Option 매개 변수에 지정된 옵션이 잘못되었습니다.

요구 사항

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