Compartilhar via

Método IHttpContext::GetServerVariable

  • Artigo

Recupera uma variável de servidor específica.

Sintaxe

virtual HRESULT GetServerVariable(  
   PCSTR pszVariableName,  
   PCWSTR * ppszValue,  
   DWORD * pcchValueLength  
) = 0;  
virtual HRESULT GetServerVariable(  
   PCSTR   pszVariableName,  
   PCSTR * ppszValue,  
   DWORD * pcchValueLength  
) = 0;

Parâmetros

pszVariableName
Um ponteiro para uma cadeia de caracteres que contém o nome da variável de servidor a ser retornada.

ppszValue
O endereço de um ponteiro para um buffer de cadeia de caracteres que recebe uma cópia da variável de servidor.

pcchValueLengthr
Um ponteiro para um DWORD buffer que recebe o comprimento do ppszValue parâmetro.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor Descrição
S_OK Indica que a operação foi bem-sucedida.
ERROR_INVALID_INDEX Indica que o parâmetro não é válido.

Comentários

O GetServerVariable método recupera uma variável de servidor especificada pelo pszVariableName parâmetro do contexto HTTP atual e retorna o valor em um buffer apontado pelo ppszValue parâmetro . A variável de servidor especificada pelo pszVariableName parâmetro pode ser uma variável personalizada ou uma variável definida em Solicitações de Comentários (RFC) 3875, "The Common Gateway Interface (CGI) Version 1.1".

Observação

O GetServerVariable método dá suporte ao retorno de valores ANSI e Unicode por meio de métodos sobrecarregados. O buffer apontado pelo ppszValue parâmetro pode ser um PCWSTR buffer ou PCSTR .

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

IHttpContext Interface
Método IHttpContext::SetServerVariable