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 |