ISecurityCallContext：：IsUserInRole 方法 (comsvcs.h)

确定指定用户是否为指定角色。

语法

HRESULT IsUserInRole(
  [in]  VARIANT      *pUser,
  [in]  BSTR         bstrRole,
  [out] VARIANT_BOOL *pfInRole
);

[in] pUser

指向值的指针，该值包含要检查其角色成员身份的用户的用户 ID。如果打算将 SID) (安全标识符传递给 IsUserInRole，则此参数应满足以下要求： V_VT(pUser) == (VT_ARRAY|VT_UI1) && V_ARRAY(pUser)->cDims == 1。

[in] bstrRole

角色的名称。

[out] pfInRole

如果用户处于指定角色，则为 TRUE;如果不是，则为 FALSE。如果未为应用程序定义指定角色，则返回 FALSE 。如果未启用基于角色的安全性，则此参数设置为 TRUE 。

此方法可以返回标准返回值E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED和E_FAIL，以及以下值。

返回代码	说明
S_OK	bstrRole 参数中指定的角色是可识别的角色，pfIsInRole 参数中返回的布尔结果指示用户是否处于该角色中。
CONTEXT_E_ROLENOTFOUND	bstrRole 参数中指定的角色不存在。

使用此方法可限制对不应执行的代码部分的访问，除非调用方是指定角色的成员。使用组件服务管理工具将 Windows 组和用户分配到应用程序的角色。有关角色的详细信息，请参阅基于角色的安全性。

由于未启用基于角色的安全性时 IsUserInRole 为 TRUE，因此最好在调用 IsUserInRole 之前调用 IsSecurityEnabled，以确保 IsUserInRole 返回有用的信息。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	comsvcs.h