다음을 통해 공유


IHttpUser 인터페이스

사용자에 대한 요청 관련 정보를 제공합니다. 이 정보에는 자격 증명 및 역할 기반 권한 부여와 같은 데이터가 포함됩니다.

구문

class IHttpUser  

메서드

다음 표에서는 인터페이스에 의해 노출되는 메서드를 나열합니다 IHttpUser .

항목 Description
DereferenceUser 사용자 내부 참조 수를 감소합니다.
GetAuthenticationType 요청 인증 유형을 반환합니다.
GetImpersonationToken 사용자 가장 토큰을 반환합니다.
GetPassword 사용자 암호를 반환합니다.
GetPrimaryToken 기본 사용자 토큰을 반환합니다.
GetRemoteUserName 원격 사용자 이름을 반환합니다.
GetUserName 사용자 이름을 반환합니다.
GetUserVariable 사용자 지정 사용자 데이터를 이름으로 반환합니다.
Isinrole 사용자에게 명명된 역할에 대한 권한이 있는지 여부를 나타내는 값을 반환합니다.
ReferenceUser 사용자 내부 참조 수를 증분합니다.
SupportsIsInRole 사용자에 대해 역할 지원을 사용할 수 있는지 여부를 나타내는 값을 반환합니다.

파생 클래스

이 인터페이스에는 파생 클래스가 없습니다.

설명

IHttpContext::GetUser 메서드를 호출하여 IHttpContext 포인터에서 포인터를 검색 IHttpUser 할 수 있습니다. 이러한 인터페이스에 액세스하려면 연습: 네이티브 코드를 사용하여 Request-Level HTTP 모듈 만들기를 참조하세요.

예제

다음 코드 예제에서는 응답 헤더 및 본문을 지우고 사용자 정보를 XML 문서로 클라이언트에 반환하는 HTTP 모듈을 만드는 방법을 보여 줍니다.

위의 코드는 응답 스트림에 다음과 유사한 XML을 씁니다.

<?xml version="1.0" ?>  
<user   
    userName="DOMAIN\user"   
    remoteName=" DOMAIN\user"   
    passWord="[hidden]"   
    authType="Negotiate"   
    impersonationToken="valid"   
    primaryToken="valid"   
    supportsRoles="true"   
    isInRole="false"   
    userVariable="NULL" />  

모듈은 RegisterModule 함수를 내보내야 합니다. 프로젝트에 대한 모듈 정의(.def) 파일을 만들어 이 함수를 내보내거나 스위치를 사용하여 /EXPORT:RegisterModule 모듈을 컴파일할 수 있습니다. 자세한 내용은 연습: 네이티브 코드를 사용하여 Request-Level HTTP 모듈 만들기를 참조하세요.

필요에 따라 각 함수에 대한 호출 규칙을 명시적으로 선언하는 대신 호출 규칙을 사용하여 __stdcall (/Gz) 코드를 컴파일할 수 있습니다.

요구 사항

형식 Description
클라이언트 - Windows Vista의 IIS 7.0
- Windows 7의 IIS 7.5
- Windows 8의 IIS 8.0
- WINDOWS 10 IIS 10.0
서버 - Windows Server 2008의 IIS 7.0
- Windows Server 2008 R2의 IIS 7.5
- Windows Server 2012의 IIS 8.0
- Windows Server 2012 R2의 IIS 8.5
- WINDOWS SERVER 2016 IIS 10.0
제품 - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
- IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
헤더 Httpserv.h

참고 항목

웹 서버 코어 인터페이스