IHttpContext::GetServerVarChanges 方法
检索对当前上下文的服务器变量所做的更改。
语法
virtual HRESULT GetServerVarChanges(
IN DWORD dwOldChangeNumber,
OUT DWORD* pdwNewChangeNumber,
IN OUT DWORD* pdwVariableSnapShot,
IN OUT PCSTR** ppVariableNameSnapShot,
IN OUT PCWSTR** ppVariableValueSnapShot,
OUT DWORD* pdwDiffedVariables,
OUT DWORD** ppDiffedVariableIndices
) = 0;
parameters
dwOldChangeNumber
[IN]一个 DWORD
包含旧更改号的 。
pdwNewChangeNumber
[OUT]指向包含新更改编号的 的指针 DWORD
。
pdwVariableSnapShot
[IN][OUT]指向 的DWORD
指针,其中包含快照中的服务器变量数。
ppVariableNameSnapShot
[IN][OUT]指向字符串数组地址的指针,该字符串数组包含快照中更改的服务器变量的名称。
ppVariableValueSnapShot
[IN][OUT]指向字符串数组地址的指针,该字符串数组包含快照中更改的服务器变量的值。
pdwDiffedVariables
[OUT]指向 的 DWORD
指针,其中包含已更改的服务器变量数。
ppDiffedVariableIndices
[OUT]指向值数组 DWORD
的地址的指针,以 –1 值结尾,其中包含已更改的服务器变量的索引。
返回值
HRESULT
。 可能的值包括(但并不限于)下表中的项。
值 | 说明 |
---|---|
S_OK | 指示操作成功。 |
备注
IIS 使用 GetServerVarChanges
方法测试自上次检查服务器变量以来 HTTP 服务器变量的更改。
注意
IIS 使用 GetServerVarChanges
方法在调用本机代码和托管代码之间在内部同步服务器变量。 开发人员在创建其 HTTP 模块时不应使用 GetServerVarChanges
方法。
要求
类型 | 说明 |
---|---|
客户端 | - 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 |
Header | Httpserv.h |