AuthzAddSidsToContext function

The AuthzAddSidsToContext function creates a copy of an existing context and appends a given set of security identifiers (SIDs) and restricted SIDs.

Syntax


BOOL WINAPI AuthzAddSidsToContext(
  _In_  AUTHZ_CLIENT_CONTEXT_HANDLE  OrigClientContext,
  _In_  PSID_AND_ATTRIBUTES          Sids,
  _In_  DWORD                        SidCount,
  _In_  PSID_AND_ATTRIBUTES          RestrictedSids,
  _In_  DWORD                        RestrictedSidCount,
  _Out_ PAUTHZ_CLIENT_CONTEXT_HANDLE pNewClientContext
);

Parameters

OrigClientContext [in]

An AUTHZ_CLIENT_CONTEXT_HANDLE structure to be copied as the basis for NewClientContext.

Sids [in]

A pointer to a SID_AND_ATTRIBUTES structure containing the SIDs and attributes to be added to the unrestricted part of the client context.

SidCount [in]

The number of SIDs to be added.

RestrictedSids [in]

A pointer to a SID_AND_ATTRIBUTES structure containing the SIDs and attributes to be added to the restricted part of the client context.

RestrictedSidCount [in]

Number of restricted SIDs to be added.

pNewClientContext [out]

A pointer to the created AUTHZ_CLIENT_CONTEXT_HANDLE structure containing input values for expiration time, identifier, flags, additional SIDs and restricted SIDs.

Return value

If the function succeeds, it returns TRUE.

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

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Windows Server 2003 Administration Tools Pack on Windows XP

Header

Authz.h

Library

Authz.lib

DLL

Authz.dll

See also

Basic Access Control Functions
SID_AND_ATTRIBUTES

 

 

Show: