Compartilhar via


IHttpUser Interface

Fornece informações específicas da solicitação sobre um usuário. Essas informações incluem dados como credenciais e autorização baseada em função.

Syntax

class IHttpUser  

Métodos

A tabela a seguir lista os métodos expostos pela IHttpUser interface .

Tópico Descrição
DereferenceUser Diminui a contagem de referência interna do usuário.
GetAuthenticationType Retorna o tipo de autenticação de solicitação.
GetImpersonationToken Retorna o token de representação do usuário.
Getpassword Retorna a senha do usuário.
GetPrimaryToken Retorna o token de usuário primário.
GetRemoteUserName Retorna o nome de usuário remoto.
Getusername Retorna nome do usuário.
GetUserVariable Retorna os dados de usuário personalizados por nome.
Isinrole Retorna um valor que indica se o usuário está autorizado para uma função nomeada.
ReferenceUser Incrementa a contagem de referência interna do usuário.
SupportsIsInRole Retorna um valor que indica se o suporte à função está habilitado para o usuário.

Classes derivadas

Essa interface não contém classes derivadas.

Comentários

Você pode recuperar um IHttpUser ponteiro de um ponteiro IHttpContext chamando o método IHttpContext::GetUser . Para obter acesso a essas interfaces, consulte Passo a passo: criando um módulo HTTP Request-Level usando código nativo.

Exemplo

O exemplo de código a seguir demonstra como criar um módulo HTTP que limpa os cabeçalhos e o corpo da resposta e retorna informações do usuário para o cliente como um documento XML.

O código acima grava XML semelhante ao seguinte ao fluxo de resposta.

<?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" />  

Seu módulo deve exportar a função RegisterModule . Você pode exportar essa função criando um arquivo de definição de módulo (.def) para seu projeto ou pode compilar o módulo usando a opção /EXPORT:RegisterModule . Para obter mais informações, consulte Passo a passo: criando um módulo HTTP Request-Level usando código nativo.

Opcionalmente, você pode compilar o código usando a __stdcall (/Gz) convenção de chamada em vez de declarar explicitamente a convenção de chamada para cada função.

Requisitos

Type Descrição
Cliente - IIS 7.0 no Windows Vista
- IIS 7.5 no Windows 7
- IIS 8.0 no Windows 8
- IIS 10.0 no Windows 10
Servidor - IIS 7.0 no Windows Server 2008
- IIS 7.5 no Windows Server 2008 R2
- IIS 8.0 no Windows Server 2012
- IIS 8.5 no Windows Server 2012 R2
- IIS 10.0 no Windows Server 2016
Produto - 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
parâmetro Httpserv.h

Consulte Também

Web Server Core Interfaces