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

参照

Web Server Core インターフェイス