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;
パラメーター
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 作成するときに メソッドを使用しないでください。
要件
| Type | 説明 |
|---|---|
| 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 |
| Header | Httpserv.h |