Expand Minimize

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft