QueryContextAttributesExW 함수(sspi.h)
전송 애플리케이션이 보안 컨텍스트의 특정 특성에 대한 보안 패키지를 쿼리할 수 있도록 합니다.
구문
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExW(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
매개 변수
[in] phContext
쿼리할 보안 컨텍스트에 대한 핸들입니다.
[in] ulAttribute
반환할 컨텍스트의 특성을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
pBuffer 매개 변수는 SecPkgContext_AccessToken 구조체에 대한 포인터를 포함합니다.
액세스 토큰에 대한 핸들을 반환합니다. |
|
pBuffer 매개 변수는 SecPkgContext_SessionAppData 구조체에 대한 포인터를 포함합니다.
세션에 대한 애플리케이션 데이터를 반환하거나 지정합니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_Authority 구조체에 대한 포인터를 포함합니다.
인증 기관의 이름을 쿼리합니다. |
|
pBuffer 매개 변수에는 클라이언트에서 제공한 초기 대상의 SPN(서비스 사용자 이름)을 나타내는 SecPkgContext_ClientSpecifiedTarget 구조체에 대한 포인터가 포함되어 있습니다.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
|
pBuffer 매개 변수는 SecPkgContext_ConnectionInfo 구조체에 대한 포인터를 포함합니다.
설정된 연결에 대한 자세한 정보를 반환합니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수에는 클라이언트 자격 증명을 지정하는 SecPkgContext_ClientCreds 구조체에 대한 포인터가 포함되어 있습니다.
클라이언트 자격 증명이 사용자 이름 및 암호인 경우 버퍼는 압축된 KERB_INTERACTIVE_LOGON 구조입니다. 클라이언트 자격 증명이 사용자 이름 및 스마트 카드 PIN인 경우 버퍼는 압축된 KERB_CERTIFICATE_LOGON 구조입니다. 클라이언트 자격 증명이 온라인 ID 자격 증명인 경우 버퍼는 마샬링된 SEC_WINNT_AUTH_IDENTITY_EX2 구조입니다. 이 특성은 CredSSP 서버에서만 지원됩니다. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
|
pBuffer 매개 변수는 SecPkgContext_DceInfo 구조체에 대한 포인터를 포함합니다.
DCE 서비스에서 사용하는 권한 부여 데이터에 대한 쿼리입니다. |
|
pBuffer 매개 변수에는 채널 바인딩 정보를 지정하는 SecPkgContext_Bindings 구조체에 대한 포인터가 포함되어 있습니다.
이 특성은 Schannel 보안 패키지에서만 지원됩니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
|
pBuffer 매개 변수는 SecPkgContext_EapKeyBlock 구조체에 대한 포인터를 포함합니다.
EAP TLS 프로토콜에서 사용하는 키 데이터에 대한 쿼리입니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_Flags 구조체에 대한 포인터를 포함합니다.
협상된 컨텍스트 플래그에 대한 정보를 반환합니다. |
|
pBuffer 매개 변수는 SecPkgContext_IssuerListInfoEx 구조체에 대한 포인터를 포함합니다.
서버에서 허용하는 인증서 발급자 목록을 반환합니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_KeyInfo 구조체에 대한 포인터를 포함합니다.
보안 컨텍스트에서 사용되는 키에 대한 정보를 쿼리합니다. |
|
pBuffer 매개 변수에는 InitializeSecurityContext 함수에 대한 최신 호출의 토큰이 클라이언트의 마지막 토큰인지 여부를 지정하는 SecPkgContext_LastClientTokenStatus 구조체에 대한 포인터가 포함되어 있습니다.
이 값은 Negotiate, Kerberos 및 NTLM 보안 패키지에서만 지원됩니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
|
pBuffer 매개 변수는 SecPkgContext_Lifespan 구조체에 대한 포인터를 포함합니다.
컨텍스트의 수명을 쿼리합니다. |
|
pBuffer 매개 변수는 PCCERT_CONTEXT 구조체에 대한 포인터를 포함합니다.
로컬 엔드 인증서가 포함된 인증서 컨텍스트를 찾습니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_LocalCredentialInfo 구조체에 대한 포인터를 포함합니다. 이 항목은 사용되지 않습니다. SECPKG_ATTR_LOCAL_CERT_CONTEXT 대체됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_Names 구조체에 대한 포인터를 포함합니다.
컨텍스트와 연결된 이름을 쿼리합니다. |
|
pBuffer 매개 변수는 SecPkgContext_NativeNames 구조체에 대한 포인터를 포함합니다.
아웃바운드 티켓에서 보안 주체 이름(CNAME)을 반환합니다. |
|
pBuffer 매개 변수는 SecPkgContext_NegotiationInfo 구조체에 대한 포인터를 포함합니다.
협상 프로세스와 함께 사용할 보안 패키지 및 해당 패키지 사용을 위한 협상의 현재 상태에 대한 정보를 반환합니다. |
|
pBuffer 매개 변수는 SecPkgContext_PackageInfo 구조체에 대한 포인터를 포함합니다.
사용 중인 SSP에 대한 정보를 반환합니다. |
|
pBuffer 매개 변수는 SecPkgContext_PasswordExpiry 구조체에 대한 포인터를 포함합니다.
암호 만료 정보를 반환합니다. |
|
pBuffer 매개 변수는 PCCERT_CONTEXT 구조체에 대한 포인터를 포함합니다.
서버에서 제공하는 최종 인증서가 포함된 인증서 컨텍스트를 찾습니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 HCERTCONTEXT에 대한 포인터를 포함합니다. 루트 저장소에서 제공하는 인증서가 포함된 인증서 컨텍스트를 찾습니다. |
|
pBuffer 매개 변수는 SecPkgContext_SessionKey 구조체에 대한 포인터를 포함합니다.
세션 키에 대한 정보를 반환합니다. |
|
pBuffer 매개 변수는 SecPkgContext_SessionInfo 구조체에 대한 포인터를 포함합니다.
세션에 대한 정보를 반환합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_Sizes 구조체에 대한 포인터를 포함합니다.
메시지별 함수에 사용되는 구조체의 크기를 쿼리합니다. |
|
pBuffer 매개 변수는 SecPkgContext_StreamSizes 구조체에 대한 포인터를 포함합니다.
메시지별 함수에 사용되는 스트림의 다양한 부분의 크기를 쿼리합니다. 이 특성은 Schannel 보안 패키지에서만 지원됩니다. |
|
pBuffer 매개 변수는 SecPkgContext_SubjectAttributes 구조체에 대한 포인터를 포함합니다.
이 값은 연결의 보안 특성에 대한 정보를 반환합니다. 이 값은 CredSSP 서버에서만 지원됩니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
|
pBuffer 매개 변수는 SecPkgContext_SupportedSignatures 구조체에 대한 포인터를 포함합니다.
이 값은 연결에 지원되는 서명 형식에 대한 정보를 반환합니다. 이 값은 Schannel 보안 패키지에서만 지원됩니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
|
pBuffer 매개 변수는 SecPkgContext_TargetInformation 구조체에 대한 포인터를 포함합니다.
원격 서버의 이름에 대한 정보를 반환합니다. |
|
pBuffer 매개 변수에는 채널 바인딩 정보를 지정하는 SecPkgContext_Bindings 구조체에 대한 포인터가 포함되어 있습니다.
이 값은 Schannel 보안 패키지에서만 지원됩니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 지원되지 않습니다. |
[out] pBuffer
특성을 수신하는 구조체에 대한 포인터입니다. 가리키는 구조체의 형식은 ulAttribute 매개 변수에 지정된 값에 따라 달라집니다.
[in] cbBuffer
pBuffer 매개 변수의 크기(바이트)입니다.
반환 값
함수가 성공하면 반환 값이 SEC_E_OK.
함수가 실패하면 반환 값은 0이 아닌 오류 코드입니다.
설명
참고
sspi.h 헤더는 QUERYContextAttributesEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | sspi.h(Security.h 포함) |
| 라이브러리 | Secur32.lib |
| DLL | Secur32.dll |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기