Export (0) Print
Expand All
Expand Minimize

AuthzInitializeContextFromAuthzContext function

The AuthzInitializeContextFromAuthzContext function creates a new client context based on an existing client context.

Starting with Windows Server 2012 and Windows 8, this function also duplicates device groups, user claims, and device claims.

Syntax


BOOL WINAPI AuthzInitializeContextFromAuthzContext(
  _In_      DWORD flags,
  _In_      AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  _In_opt_  PLARGE_INTEGER pExpirationTime,
  _In_      LUID Identifier,
  _In_      PVOID DynamicGroupArgs,
  _Out_     PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext
);

Parameters

flags [in]

Reserved for future use.

hAuthzClientContext [in]

The handle to an existing client context.

pExpirationTime [in, optional]

Sets the time limit for how long the returned context structure is valid. If no value is passed, then the token never expires. Expiration time is not currently enforced.

Identifier [in]

The specific identifier for the resource manager.

DynamicGroupArgs [in]

A pointer to parameters to be passed to the callback function that computes dynamic groups. If the value is NULL, then the callback function is not called.

phNewAuthzClientContext [out]

A pointer to the duplicated AUTHZ_CLIENT_CONTEXT_HANDLE handle. When you have finished using the handle, release it by calling the AuthzFreeContext function.

Return value

If the function succeeds, it returns TRUE.

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

Remarks

This function calls the AuthzComputeGroupsCallback callback function to add security identifiers to the newly created context.

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
AUTHZ_ACCESS_REPLY

 

 

Community Additions

ADD
Show:
© 2014 Microsoft