IHttpContext::GetServerVariable 메서드
특정 서버 변수를 검색합니다.
구문
virtual HRESULT GetServerVariable(
PCSTR pszVariableName,
PCWSTR * ppszValue,
DWORD * pcchValueLength
) = 0;
virtual HRESULT GetServerVariable(
PCSTR pszVariableName,
PCSTR * ppszValue,
DWORD * pcchValueLength
) = 0;
매개 변수
pszVariableName
반환할 서버 변수의 이름을 포함하는 문자열에 대한 포인터입니다.
ppszValue
서버 변수의 복사본을 수신하는 문자열 버퍼에 대한 포인터의 주소입니다.
pcchValueLengthr
매개 변수의 길이를 DWORD 수신하는 버퍼에 대한 포인터입니다 ppszValue .
반환 값
HRESULT입니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 값 | 설명 |
|---|---|
| S_OK | 작업이 성공했음을 나타냅니다. |
| ERROR_INVALID_INDEX | 매개 변수가 잘못되었음을 나타냅니다. |
설명
메서드는 GetServerVariable 현재 HTTP 컨텍스트에서 매개 변수로 지정된 서버 변수를 pszVariableName 검색하고 매개 변수가 가리키는 ppszValue 버퍼의 값을 반환합니다. 매개 변수로 pszVariableName 지정된 서버 변수는 사용자 지정 변수이거나 RFC(Requests for Comments) 3875, "CGI(Common Gateway Interface) 버전 1.1"에 정의된 변수일 수 있습니다.
참고
메서드는 GetServerVariable 오버로드된 메서드를 통해 ANSI 및 유니코드 값을 모두 반환할 수 있습니다. 매개 변수가 가리키는 버퍼는 ppszValue 또는 PCSTR 버퍼일 PCWSTR 수 있습니다.
요구 사항
| 형식 | Description |
|---|---|
| 클라이언트 | - Windows Vista의 IIS 7.0 - Windows 7의 IIS 7.5 - Windows 8의 IIS 8.0 - WINDOWS 10 IIS 10.0 |
| 서버 | - Windows Server 2008의 IIS 7.0 - Windows Server 2008 R2의 IIS 7.5 - Windows Server 2012의 IIS 8.0 - Windows Server 2012 R2의 IIS 8.5 - WINDOWS SERVER 2016 IIS 10.0 |
| 제품 | - 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 |
| 헤더 | Httpserv.h |