IHttpUser::SupportsIsInRole 方法

返回一个值,该值指示是否为用户启用角色支持。

语法

virtual BOOL SupportsIsInRole(  
   VOID  
) = 0;  

参数

此方法不采用参数。

返回值

true 如果为用户启用了角色支持,则为 ;否则为 false

备注

返回 SupportsIsInRole 值取决于实现。 应将以下信息用作指南,但并非所有情况都正确:

  • 如果 IHttpUser 实现程序处理托管或匿名身份验证, SupportsIsInRoletrue返回 。

  • IHttpUser如果实施者实现自定义、基本、认证映射或 SSPI 身份验证,SupportsIsInRolefalse返回 。

示例

下面的代码示例演示如何创建一个 HTTP 模块,该模块清除响应标头和正文,然后将用户信息作为 XML 文档返回给客户端。

上述代码将类似于以下内容的 XML 写入响应流。

<?xml version="1.0" ?>  
<user supportsRoles="true" />  

模块必须导出 RegisterModule 函数。 可以通过为项目创建模块定义 (.def) 文件导出此函数,也可以使用 开关编译模块 /EXPORT:RegisterModule 。 有关详细信息,请参阅 演练:使用本机代码创建Request-Level HTTP 模块

可以选择使用调用约定编译代码, __stdcall (/Gz) 而不是为每个函数显式声明调用约定。

要求

类型 说明
客户端 - 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

另请参阅

IHttpUser 接口