IHttpUser インターフェイス
ユーザーに関する要求固有の情報を提供します。 この情報には、資格情報やロールベースの承認などのデータが含まれます。
構文
class IHttpUser
メソッド
次の表に、 インターフェイスによって公開されるメソッドの一覧を IHttpUser 示します。
| トピック | 説明 |
|---|---|
| DereferenceUser | ユーザーの内部参照カウントをデクリメントします。 |
| GetAuthenticationType | 要求認証の種類を返します。 |
| GetImpersonationToken | ユーザー偽装トークンを返します。 |
| GetPassword | ユーザー パスワードを返します。 |
| GetPrimaryToken | プライマリ ユーザー トークンを返します。 |
| GetRemoteUserName | リモート ユーザー名を返します。 |
| GetUserName | ユーザー名を返します。 |
| GetUserVariable | カスタム ユーザー データを名前で返します。 |
| Isinrole | ユーザーが名前付きロールに対して承認されているかどうかを示す値を返します。 |
| ReferenceUser | ユーザーの内部参照数をインクリメントします。 |
| SupportsIsInRole | ユーザーに対してロールのサポートが有効になっているかどうかを示す値を返します。 |
派生クラス
このインターフェイスには、派生クラスが含まれています。
解説
IHttpContext::GetUser メソッドを呼び出すことで、IHttpContext ポインターからポインターを取得IHttpUserできます。 これらのインターフェイスにアクセスするには、「 チュートリアル: ネイティブ コードを使用したRequest-Level HTTP モジュールの作成」を参照してください。
例
次のコード例では、応答ヘッダーと本文をクリアし、ユーザー情報を XML ドキュメントとしてクライアントに返す HTTP モジュールを作成する方法を示します。
上記のコードは、次のような XML を応答ストリームに書き込みます。
<?xml version="1.0" ?>
<user
userName="DOMAIN\user"
remoteName=" DOMAIN\user"
passWord="[hidden]"
authType="Negotiate"
impersonationToken="valid"
primaryToken="valid"
supportsRoles="true"
isInRole="false"
userVariable="NULL" />
モジュールは RegisterModule 関数をエクスポートする必要があります。 この関数をエクスポートするには、プロジェクトのモジュール定義 (.def) ファイルを作成するか、スイッチを使用してモジュールを /EXPORT:RegisterModule コンパイルします。 詳細については、「 チュートリアル: ネイティブ コードを使用したRequest-Level HTTP モジュールの作成」を参照してください。
必要に応じて、各関数の呼び出し規約を __stdcall (/Gz) 明示的に宣言するのではなく、呼び出し規約を使用してコードをコンパイルできます。
要件
| 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 |