Expand Minimize
This topic has not yet been rated - Rate this topic

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

 

 

Send comments about this topic to Microsoft

Build date: 10/26/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.