IHttpUser::SupportsIsInRole メソッド
ユーザーに対してロールのサポートが有効になっているかどうかを示す値を返します。
構文
virtual BOOL SupportsIsInRole(
VOID
) = 0;
パラメーター
このメソッドは、パラメーターを受け取りません。
戻り値
true
ユーザーに対してロールのサポートが有効になっている場合。それ以外の場合は false
。
解説
戻り値は SupportsIsInRole
実装によって異なります。 ガイドラインとして次の情報を使用する必要がありますが、すべてのシナリオで正しくない場合があります。
IHttpUser 実装者がマネージド認証または匿名認証を処理する場合、
SupportsIsInRole
は を返しますtrue
。実装者が
IHttpUser
カスタム、基本、認定マッピング、または SSPI 認証を実装する場合は、SupportsIsInRole
を返しますfalse
。
例
次のコード例では、応答ヘッダーと本文をクリアし、ユーザー情報を XML ドキュメントとしてクライアントに返す HTTP モジュールを作成する方法を示します。
上記のコードは、次のような XML を応答ストリームに書き込みます。
<?xml version="1.0" ?>
<user supportsRoles="true" />
モジュールは 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 |