Método IHttpUser::GetUserVariable

Retorna os dados de usuário personalizados por nome.

Sintaxe

virtual PVOID GetUserVariable(  
   IN PCSTR pszVariableName  
) = 0;  

Parâmetros

pszVariableName
[IN] Um ponteiro para uma cadeia de caracteres terminada em nulo constante que contém o nome da variável dos dados a serem recuperados.

Valor Retornado

Um void ponteiro que contém os dados personalizados de upcast.

Comentários

O padrão é HTTP_USER_VARIABLE_SID, que é definido no arquivo de cabeçalho Httpserv.h.

Notas para implementadores

Os implementadores IHttpUser 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 delete o void 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 delete o ponteiro retornado void quando esses dados não são mais necessários. Além disso, os clientes não devem alterar o estado da memória referenciada por esse void ponteiro, pois 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 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" />  

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

Tipo	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