Método IHttpUser::GetUserName

Retorna nome do usuário.

Sintaxe

virtual PCWSTR GetUserName(  
   VOID  
) = 0;  

Parâmetros

Este método não aceita parâmetros.

Valor Retornado

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo constante que contém o nome de usuário.

Comentários

O valor retornado depende do tipo de autenticação. O tipo de autenticação é retornado do método GetAuthenticationType .

A tabela a seguir mostra os tipos de autenticação com os valores de nome de usuário ou padrão associados.

Tipo de autenticação	Nome de usuário
Anônima	cadeia de caracteres vazia
Basic	Domínio\Username
Digest	domain\username ou username
Formulários	Nome de Usuário
Windows	Domínio\Username

Notas para implementadores

IHttpUser os implementadores são responsáveis pelo gerenciamento de memória com esses dados; Portanto, IHttpUser os implementadores que usam alocação de memória dinâmica devem liberar ou chamar delete no PCWSTR ponteiro quando ele não for mais necessário.

Observações para chamadores

IHttpUser os implementadores são responsáveis pelo gerenciamento de memória com esses dados; Portanto, IHttpUser os clientes não devem liberar ou chamar delete no ponteiro retornado PCWSTR quando esses dados não forem mais necessários. Além disso, os clientes não devem converter esses dados em um ponteiro que não seja um const ou alterar o estado da memória referenciada por este PCWSTR; caso contrário, uma violação de acesso será gerada ou os dados se tornarão inválidos.

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, em seguida, retorna informações do usuário para o cliente como um documento XML.

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

<?xml version="1.0" ?>  
<user userName="DOMAIN\user" />  

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

IHttpUser Interface
Método IHttpUser::GetPassword
Método IHttpUser::GetRemoteUserName