Expand Minimize

AuthzModifySids function

The AuthzModifySids function adds, deletes, or modifies user and device groups in the Authz client context.

Syntax


BOOL WINAPI AuthzModifySids(
  _In_      AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  _In_      AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  _In_      PAUTHZ_SID_OPERATION pSidOperations,
  _In_opt_  PTOKEN_GROUPS pSids
);

Parameters

hAuthzClientContext [in]

A handle to the client context to be modified.

SidClass [in]

Type of information to be modified. The caller can specify AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids, or AuthzContextInfoDeviceSids.

pSidOperations [in]

A pointer to an array of AUTHZ_SID_OPERATION enumeration values that specify the group modifications to make.

pSids [in, optional]

A pointer to a TOKEN_GROUPS structure that specifies the groups to modify.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Remarks

The AUTHZ_SID_OPERATION enumeration must have only one element if the value of that element is AUTHZ_SID_OPERATION_REPLACE_ALL. Otherwise, the array has the same number of elements as the corresponding PTOKEN_GROUPS.

When you want to use AuthzModifySids to delete, the SIDs are matched but not the SID flags. If no matching SID is found, no modifications are done and the call fails.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Authz.h

Library

Authz.lib

DLL

Authz.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft