SaslGetContextOption 함수(sspi.h)

  • 아티클

SaslGetContextOption 함수는 지정된 SASL 컨텍스트의 지정된 속성을 검색합니다.

구문

SECURITY_STATUS SEC_ENTRY SaslGetContextOption(
  [in]            PCtxtHandle ContextHandle,
  [in]            ULONG       Option,
  [out]           PVOID       Value,
  [out]           ULONG       Size,
  [out, optional] PULONG      Needed
);

매개 변수

[in] ContextHandle

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

[in] Option

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

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

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

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

로컬 컴퓨터에서 받는 버퍼의 최대 크기입니다.
SASL_OPTION_SEND_SIZE
 버퍼의 데이터 형식: ULONG

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

[out] Value

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

[out] Size

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

[out, optional] Needed

Value 매개 변수로 지정된 버퍼가 Option 매개 변수로 지정된 속성의 데이터 값을 포함할 만큼 크지 않은 경우 값을 반환하는 부호 없는 LONG 값에 대한 포인터입니다.

반환 값

호출이 성공적으로 완료되면 이 함수는 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