authzModifySids 函数 (authz.h)

  • 项目

AuthzModifySids 函数在 Authz 客户端上下文中添加、删除或修改用户和设备组。

语法

AUTHZAPI BOOL AuthzModifySids(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  [in]           PAUTHZ_SID_OPERATION            pSidOperations,
  [in, optional] PTOKEN_GROUPS                   pSids
);

参数

[in] hAuthzClientContext

要修改的客户端上下文的句柄。

[in] SidClass

要修改的信息的类型。 调用方可以指定 AuthzContextInfoGroupsSids、AuthzContextInfoRestrictedSids 或 AuthzContextInfoDeviceSids。

[in] pSidOperations

指向 AUTHZ_SID_OPERATION 枚举值的数组的指针，这些值指定要执行的组修改。

[in, optional] pSids

指向 TOKEN_GROUPS 结构的指针，该结构指定要修改的组。

返回值

如果该函数成功，则返回 TRUE。

如果函数失败，则返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

如果 AUTHZ_SID_OPERATION_REPLACE_ALL 该元素的值，则AUTHZ_SID_OPERATION枚举必须只有一个元素。 否则，数组的元素数与相应的PTOKEN_GROUPS相同。

如果要使用 AuthzModifySids 进行删除，SID 将匹配，但 SID 标志不匹配。 如果未找到匹配的 SID，则不会进行任何修改，并且调用将失败。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 authz.h
Library Authz.lib
DLL Authz.dll