擷取目前內容之伺服器變數的變更。
語法
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;
參數
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 使用 方法，在內部同步處理原生和 Managed 程式碼呼叫之間的伺服器變數。 開發人員不應該在建立其 HTTP 模組時使用 GetServerVarChanges 方法。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - 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 |