precomp.h File Reference

#include <stdarg.h>
#include <windef.h>
#include <winbase.h>
#include <wingdi.h>
#include <ole2.h>
#include <objsel.h>
#include <aclui.h>
#include <ndk/rtlfuncs.h>

Include dependency graph for precomp.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_ACE_ENTRY
struct	_PRINCIPAL_LISTITEM
struct	_SECURITY_PAGE
struct	_NMCHANGEITEMCHECKBOX
struct	_SIDREQRESULT

Macros
#define	_ACLUI_
#define	WIN32_NO_STATUS
#define	_INC_WINDOWS
#define	COM_NO_WINDOWS_H
#define	NTOS_MODE_USER
#define	EnableRedrawWindow(hwnd)   SendMessage((hwnd), WM_SETREDRAW, TRUE, 0)
#define	DisableRedrawWindow(hwnd)   SendMessage((hwnd), WM_SETREDRAW, FALSE, 0)
#define	CIS_DENYDISABLED   (0x8)
#define	CIS_DENYENABLED   (0x0)
#define	CIS_ALLOWDISABLED   (0x4)
#define	CIS_ALLOWENABLED   (0x0)
#define	CIS_ALLOW   (0x2)
#define	CIS_DENY   (0x1)
#define	CIS_NONE   (0x0)
#define	CIS_DISABLED   (CIS_ALLOWDISABLED | CIS_DENYDISABLED)
#define	CLB_ALLOW   (0x1)
#define	CLB_DENY   (0x0)
#define	CIS_MASK   (CIS_DISABLED | CIS_ALLOW | CIS_DENY)
#define	CLM_ADDITEM   (WM_USER + 1)
#define	CLM_DELITEM   (WM_USER + 2)
#define	CLM_GETITEMCOUNT   (WM_USER + 3)
#define	CLM_CLEAR   (WM_USER + 4)
#define	CLM_SETCHECKBOXCOLUMN   (WM_USER + 5)
#define	CLM_GETCHECKBOXCOLUMN   (WM_USER + 6)
#define	CLM_CLEARCHECKBOXES   (WM_USER + 7)
#define	CLM_SETITEMSTATE   (WM_USER + 8)
#define	CLM_ENABLEQUICKSEARCH   (WM_USER + 9)
#define	CLM_SETQUICKSEARCH_TIMEOUT_RESET   (WM_USER + 10)
#define	CLM_SETQUICKSEARCH_TIMEOUT_SETFOCUS   (WM_USER + 11)
#define	CLM_FINDITEMBYACCESSMASK   (WM_USER + 12)
#define	CLN_CHANGINGITEMCHECKBOX   (101)

Typedefs
typedef struct _ACE_ENTRY	ACE_ENTRY
typedef struct _ACE_ENTRY *	PACE_ENTRY
typedef struct _PRINCIPAL_LISTITEM	PRINCIPAL_LISTITEM
typedef struct _PRINCIPAL_LISTITEM *	PPRINCIPAL_LISTITEM
typedef struct _SECURITY_PAGE	SECURITY_PAGE
typedef struct _SECURITY_PAGE *	PSECURITY_PAGE
typedef BOOL(*	POBJPICK_SELECTED_SID) (IN IDsObjectPicker *pDsObjectPicker, IN HWND hwndParent OPTIONAL, IN PSID pSid, IN PVOID Context OPTIONAL)
typedef struct _NMCHANGEITEMCHECKBOX	NMCHANGEITEMCHECKBOX
typedef struct _NMCHANGEITEMCHECKBOX *	PNMCHANGEITEMCHECKBOX
typedef struct _SIDREQRESULT	SIDREQRESULT
typedef struct _SIDREQRESULT *	PSIDREQRESULT
typedef VOID(*	PSIDREQCOMPLETIONPROC) (IN HANDLE SidCacheMgr, IN PSID Sid, IN PSIDREQRESULT SidRequestResult, IN PVOID Context)

Functions
DWORD	LoadAndFormatString (IN HINSTANCE hInstance, IN UINT uID, OUT LPWSTR *lpTarget,...)
LPARAM	ListViewGetSelectedItemData (IN HWND hwnd)
BOOL	ListViewSelectItem (IN HWND hwnd, IN INT Index)
HRESULT	InitializeObjectPicker (IN PCWSTR ServerName, IN PSI_OBJECT_INFO ObjectInfo, OUT IDsObjectPicker **pDsObjectPicker)
VOID	FreeObjectPicker (IN IDsObjectPicker *pDsObjectPicker)
HRESULT	InvokeObjectPickerDialog (IN IDsObjectPicker *pDsObjectPicker, IN HWND hwndParent OPTIONAL, IN POBJPICK_SELECTED_SID SelectedSidCallback, IN PVOID Context OPTIONAL)
BOOL	RegisterCheckListControl (HINSTANCE hInstance)
VOID	UnregisterCheckListControl (HINSTANCE hInstance)
BOOL WINAPI	DllMain (IN HINSTANCE hinstDLL, IN DWORD dwReason, IN LPVOID lpvReserved)
HANDLE	CreateSidCacheMgr (IN HANDLE Heap, IN LPCWSTR SystemName)
VOID	DestroySidCacheMgr (IN HANDLE SidCacheMgr)
VOID	DequeueSidLookup (IN HANDLE SidCacheMgr, IN PSID pSid)
BOOL	LookupSidCache (IN HANDLE SidCacheMgr, IN PSID pSid, IN PSIDREQCOMPLETIONPROC CompletionProc, IN PVOID Context)
VOID	ReferenceSidReqResult (IN HANDLE SidCacheMgr, IN PSIDREQRESULT ReqResult)
VOID	DereferenceSidReqResult (IN HANDLE SidCacheMgr, IN PSIDREQRESULT ReqResult)

Variables
HINSTANCE	hDllInstance

Macro Definition Documentation

_ACLUI_

#define _ACLUI_

Definition at line 4 of file precomp.h.

_INC_WINDOWS

#define _INC_WINDOWS

Definition at line 9 of file precomp.h.

CIS_ALLOW

#define CIS_ALLOW   (0x2)

Definition at line 117 of file precomp.h.

CIS_ALLOWDISABLED

#define CIS_ALLOWDISABLED   (0x4)

Definition at line 115 of file precomp.h.

CIS_ALLOWENABLED

#define CIS_ALLOWENABLED   (0x0)

Definition at line 116 of file precomp.h.

CIS_DENY

#define CIS_DENY   (0x1)

Definition at line 118 of file precomp.h.

CIS_DENYDISABLED

#define CIS_DENYDISABLED   (0x8)

Definition at line 113 of file precomp.h.

CIS_DENYENABLED

#define CIS_DENYENABLED   (0x0)

Definition at line 114 of file precomp.h.

CIS_DISABLED

#define CIS_DISABLED   (CIS_ALLOWDISABLED | CIS_DENYDISABLED)

Definition at line 120 of file precomp.h.

CIS_MASK

#define CIS_MASK   (CIS_DISABLED | CIS_ALLOW | CIS_DENY)

Definition at line 125 of file precomp.h.

CIS_NONE

#define CIS_NONE   (0x0)

Definition at line 119 of file precomp.h.

CLB_ALLOW

#define CLB_ALLOW   (0x1)

Definition at line 122 of file precomp.h.

CLB_DENY

#define CLB_DENY   (0x0)

Definition at line 123 of file precomp.h.

CLM_ADDITEM

#define CLM_ADDITEM   (WM_USER + 1)

Definition at line 127 of file precomp.h.

CLM_CLEAR

#define CLM_CLEAR   (WM_USER + 4)

Definition at line 130 of file precomp.h.

CLM_CLEARCHECKBOXES

#define CLM_CLEARCHECKBOXES   (WM_USER + 7)

Definition at line 133 of file precomp.h.

CLM_DELITEM

#define CLM_DELITEM   (WM_USER + 2)

Definition at line 128 of file precomp.h.

CLM_ENABLEQUICKSEARCH

#define CLM_ENABLEQUICKSEARCH   (WM_USER + 9)

Definition at line 135 of file precomp.h.

CLM_FINDITEMBYACCESSMASK

#define CLM_FINDITEMBYACCESSMASK   (WM_USER + 12)

Definition at line 138 of file precomp.h.

CLM_GETCHECKBOXCOLUMN

#define CLM_GETCHECKBOXCOLUMN   (WM_USER + 6)

Definition at line 132 of file precomp.h.

CLM_GETITEMCOUNT

#define CLM_GETITEMCOUNT   (WM_USER + 3)

Definition at line 129 of file precomp.h.

CLM_SETCHECKBOXCOLUMN

#define CLM_SETCHECKBOXCOLUMN   (WM_USER + 5)

Definition at line 131 of file precomp.h.

CLM_SETITEMSTATE

#define CLM_SETITEMSTATE   (WM_USER + 8)

Definition at line 134 of file precomp.h.

CLM_SETQUICKSEARCH_TIMEOUT_RESET

#define CLM_SETQUICKSEARCH_TIMEOUT_RESET   (WM_USER + 10)

Definition at line 136 of file precomp.h.

CLM_SETQUICKSEARCH_TIMEOUT_SETFOCUS

#define CLM_SETQUICKSEARCH_TIMEOUT_SETFOCUS   (WM_USER + 11)

Definition at line 137 of file precomp.h.

CLN_CHANGINGITEMCHECKBOX

#define CLN_CHANGINGITEMCHECKBOX   (101)

Definition at line 140 of file precomp.h.

COM_NO_WINDOWS_H

#define COM_NO_WINDOWS_H

Definition at line 10 of file precomp.h.

DisableRedrawWindow

#define DisableRedrawWindow

(

hwnd

)

SendMessage((hwnd), WM_SETREDRAW, FALSE, 0)

Definition at line 24 of file precomp.h.

EnableRedrawWindow

#define EnableRedrawWindow

(

hwnd

)

SendMessage((hwnd), WM_SETREDRAW, TRUE, 0)

Definition at line 21 of file precomp.h.

NTOS_MODE_USER

#define NTOS_MODE_USER

Definition at line 18 of file precomp.h.

WIN32_NO_STATUS

#define WIN32_NO_STATUS

Definition at line 8 of file precomp.h.

Typedef Documentation

ACE_ENTRY

typedef struct _ACE_ENTRY ACE_ENTRY

NMCHANGEITEMCHECKBOX

typedef struct _NMCHANGEITEMCHECKBOX NMCHANGEITEMCHECKBOX

PACE_ENTRY

typedef struct _ACE_ENTRY * PACE_ENTRY

PNMCHANGEITEMCHECKBOX

typedef struct _NMCHANGEITEMCHECKBOX * PNMCHANGEITEMCHECKBOX

POBJPICK_SELECTED_SID

typedef BOOL(* POBJPICK_SELECTED_SID) (IN IDsObjectPicker *pDsObjectPicker, IN HWND hwndParent OPTIONAL, IN PSID pSid, IN PVOID Context OPTIONAL)

Definition at line 100 of file precomp.h.

PPRINCIPAL_LISTITEM

typedef struct _PRINCIPAL_LISTITEM * PPRINCIPAL_LISTITEM

PRINCIPAL_LISTITEM

typedef struct _PRINCIPAL_LISTITEM PRINCIPAL_LISTITEM

PSECURITY_PAGE

typedef struct _SECURITY_PAGE * PSECURITY_PAGE

PSIDREQCOMPLETIONPROC

typedef VOID(* PSIDREQCOMPLETIONPROC) (IN HANDLE SidCacheMgr, IN PSID Sid, IN PSIDREQRESULT SidRequestResult, IN PVOID Context)

Definition at line 175 of file precomp.h.

PSIDREQRESULT

typedef struct _SIDREQRESULT * PSIDREQRESULT

SECURITY_PAGE

typedef struct _SECURITY_PAGE SECURITY_PAGE

SIDREQRESULT

typedef struct _SIDREQRESULT SIDREQRESULT

Function Documentation

CreateSidCacheMgr()

HANDLE CreateSidCacheMgr	(	IN HANDLE	Heap,
		IN LPCWSTR	SystemName
	)

Definition at line 596 of file sidcache.c.

{
    PSIDCACHEMGR scm;

    if (SystemName == NULL)
        SystemName = L"";

    scm = HeapAlloc(Heap,
                    0,
                    FIELD_OFFSET(SIDCACHEMGR,
                                 SystemName[wcslen(SystemName) + 1]));
    if (scm != NULL)
    {
        /* zero the static part of the structure */
        ZeroMemory(scm,
                   FIELD_OFFSET(SIDCACHEMGR,
                                SystemName));

        scm->RefCount = 1;
        scm->Heap = Heap;

        wcscpy(scm->SystemName,
               SystemName);

        InitializeCriticalSection(&scm->Lock);
        InitializeListHead(&scm->QueueListHead);
        InitializeListHead(&scm->CacheListHead);

        scm->LookupEvent = CreateEvent(NULL,
                                       FALSE,
                                       FALSE,
                                       NULL);
        if (scm->LookupEvent == NULL)
        {
            goto Cleanup;
        }

        if (!OpenLSAPolicyHandle(scm->SystemName,
                                 POLICY_LOOKUP_NAMES | POLICY_VIEW_LOCAL_INFORMATION,
                                 &scm->LsaHandle))
        {
            goto Cleanup;
        }

        scm->LookupThread = CreateThread(NULL,
                                         0,
                                         LookupThreadProc,
                                         scm,
                                         0,
                                         NULL);
        if (scm->LookupThread == NULL)
        {
Cleanup:
            if (scm->LookupEvent != NULL)
            {
                CloseHandle(scm->LookupEvent);
            }

            if (scm->LsaHandle != NULL)
            {
                LsaClose(scm->LsaHandle);
            }

            HeapFree(Heap,
                     0,
                     scm);
            scm = NULL;
        }
    }
    else
    {
        SetLastError(ERROR_NOT_ENOUGH_MEMORY);
    }

    return (HANDLE)scm;
}

Referenced by CreateSecurityPage().

DequeueSidLookup()

VOID DequeueSidLookup	(	IN HANDLE	SidCacheMgr,
		IN PSID	pSid
	)

Definition at line 791 of file sidcache.c.

{
    PLIST_ENTRY CurrentEntry;
    PSIDQUEUEENTRY QueueEntry;
    PSIDCACHEMGR scm;

    scm = ReferenceSidCacheMgr(SidCacheMgr);
    if (scm != NULL)
    {
        EnterCriticalSection(&scm->Lock);

        if (scm->QueueLookingUp != NULL &&
            EqualSid(pSid,
                     (PSID)(scm->QueueLookingUp + 1)))
        {
            /* don't free the queue lookup item! this will be
               done in the lookup thread */
            scm->QueueLookingUp = NULL;
        }
        else
        {
            for (CurrentEntry = scm->QueueListHead.Flink;
                 CurrentEntry != &scm->QueueListHead;
                 CurrentEntry = CurrentEntry->Flink)
            {
                QueueEntry = CONTAINING_RECORD(CurrentEntry,
                                               SIDQUEUEENTRY,
                                               ListEntry);

                if (EqualSid(pSid,
                             (PSID)(QueueEntry + 1)))
                {
                    FreeQueueEntry(scm,
                                   QueueEntry);
                    break;
                }
            }
        }

        LeaveCriticalSection(&scm->Lock);

        DereferenceSidCacheMgr(scm);
    }
}

DereferenceSidReqResult()

VOID DereferenceSidReqResult	(	IN HANDLE	SidCacheMgr,
		IN PSIDREQRESULT	ReqResult
	)

Definition at line 855 of file sidcache.c.

{
    PSIDCACHEMGR scm;

    scm = ReferenceSidCacheMgr(SidCacheMgr);
    if (scm != NULL)
    {
        if (InterlockedDecrement(&ReqResult->RefCount) == 0)
        {
            HeapFree(scm->Heap,
                     0,
                     ReqResult);
        }

        DereferenceSidCacheMgr(scm);
    }
}

Referenced by FreePrincipalsList(), LookupSidCache(), LookupThreadProc(), and UpdatePrincipalListItem().

DestroySidCacheMgr()

VOID DestroySidCacheMgr

(

IN HANDLE

SidCacheMgr

)

Definition at line 676 of file sidcache.c.

{
    PSIDCACHEMGR scm = HandleToScm(SidCacheMgr);

    if (scm != NULL)
    {
        /* remove the keep-alive reference */
        DereferenceSidCacheMgr(scm);
    }
}

Referenced by CreateSecurityPage(), and DestroySecurityPage().

DllMain()

BOOL WINAPI DllMain	(	IN HINSTANCE	hDllInstance,
		IN DWORD	fdwReason,
		IN LPVOID	lpvReserved
	)

@DllMain

Core routine of the Utility Manager's library.

Parameters

[in]	hDllInstance	The entry point instance of the library.
[in]	fdwReason	The reason argument to indicate the motive DllMain is being called.
[in]	lpvReserved	Reserved.

Returns

Returns TRUE when main call initialization has succeeded, FALSE otherwise.

Definition at line 95 of file kbsdll.c.

{
    switch (dwReason)
    {
        case DLL_PROCESS_ATTACH:
        {
            hInstance = hinstDLL;
            hKbSwitchWnd = FindWindow(szKbSwitcherName, NULL);
            if (!hKbSwitchWnd)
            {
                return FALSE;
            }
        }
        break;
    }

    return TRUE;
}

FreeObjectPicker()

VOID FreeObjectPicker

(

IN IDsObjectPicker *

pDsObjectPicker

)

Definition at line 335 of file misc.c.

{
    pDsObjectPicker->lpVtbl->Release(pDsObjectPicker);
}

InitializeObjectPicker()

HRESULT InitializeObjectPicker	(	IN PCWSTR	ServerName,
		IN PSI_OBJECT_INFO	ObjectInfo,
		OUT IDsObjectPicker **	pDsObjectPicker
	)

Definition at line 176 of file misc.c.

{
    HRESULT hRet;

    *pDsObjectPicker = NULL;

    hRet = CoCreateInstance(&CLSID_DsObjectPicker,
                            NULL,
                            CLSCTX_INPROC_SERVER,
                            &IID_IDsObjectPicker,
                            (LPVOID*)pDsObjectPicker);
    if (SUCCEEDED(hRet))
    {
        DSOP_INIT_INFO InitInfo;
        UINT i;
        static DSOP_SCOPE_INIT_INFO Scopes[] =
        {
            {
                sizeof(DSOP_SCOPE_INIT_INFO),
                DSOP_SCOPE_TYPE_TARGET_COMPUTER,
                DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS | DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS |
                    DSOP_SCOPE_FLAG_STARTING_SCOPE,
                {
                    {
                        0,
                        0,
                        0
                    },
                    DSOP_DOWNLEVEL_FILTER_USERS | DSOP_DOWNLEVEL_FILTER_LOCAL_GROUPS |
                        DSOP_DOWNLEVEL_FILTER_GLOBAL_GROUPS | DSOP_DOWNLEVEL_FILTER_ALL_WELLKNOWN_SIDS
                },
                NULL,
                NULL,
                S_OK
            },
        };

        InitInfo.cbSize = sizeof(InitInfo);
        InitInfo.pwzTargetComputer = ServerName;
        InitInfo.cDsScopeInfos = sizeof(Scopes) / sizeof(Scopes[0]);
        InitInfo.aDsScopeInfos = Scopes;
        InitInfo.flOptions = DSOP_FLAG_MULTISELECT;
        InitInfo.cAttributesToFetch = sizeof(ObjectPickerAttributes) / sizeof(ObjectPickerAttributes[0]);
        InitInfo.apwzAttributeNames = ObjectPickerAttributes;

        for (i = 0; i < InitInfo.cDsScopeInfos; i++)
        {
            if ((ObjectInfo->dwFlags & SI_SERVER_IS_DC) &&
                (InitInfo.aDsScopeInfos[i].flType & DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN))
            {
                /* only set the domain controller string if we know the target
                   computer is a domain controller and the scope type is an
                   up-level domain to which the target computer is joined */
                InitInfo.aDsScopeInfos[i].pwzDcName = InitInfo.pwzTargetComputer;
            }
        }

        hRet = (*pDsObjectPicker)->lpVtbl->Initialize(*pDsObjectPicker,
                                                      &InitInfo);

        if (FAILED(hRet))
        {
            /* delete the object picker in case initialization failed! */
            (*pDsObjectPicker)->lpVtbl->Release(*pDsObjectPicker);
        }
    }

    return hRet;
}

Referenced by SecurityPageProc().

InvokeObjectPickerDialog()

HRESULT InvokeObjectPickerDialog	(	IN IDsObjectPicker *	pDsObjectPicker,
		IN HWND hwndParent	OPTIONAL,
		IN POBJPICK_SELECTED_SID	SelectedSidCallback,
		IN PVOID Context	OPTIONAL
	)

Definition at line 249 of file misc.c.

{
    IDataObject *pdo = NULL;
    HRESULT hRet;

    hRet = pDsObjectPicker->lpVtbl->InvokeDialog(pDsObjectPicker,
                                                 hwndParent,
                                                 &pdo);
    if (hRet == S_OK)
    {
        STGMEDIUM stm;
        FORMATETC fe;

        fe.cfFormat = (WORD)RegisterClipboardFormat(CFSTR_DSOP_DS_SELECTION_LIST);
        fe.ptd = NULL;
        fe.dwAspect = DVASPECT_CONTENT;
        fe.lindex = -1;
        fe.tymed = TYMED_HGLOBAL;

        hRet = pdo->lpVtbl->GetData(pdo,
                                    &fe,
                                    &stm);
        if (SUCCEEDED(hRet))
        {
            PDS_SELECTION_LIST SelectionList = (PDS_SELECTION_LIST)GlobalLock(stm.hGlobal);
            if (SelectionList != NULL)
            {
                LPVARIANT vSid;
                PSID pSid;
                UINT i;
                BOOL contLoop = TRUE;

                for (i = 0; i < SelectionList->cItems && contLoop; i++)
                {
                    vSid = SelectionList->aDsSelection[i].pvarFetchedAttributes;

                    if (vSid != NULL && V_VT(vSid) == (VT_ARRAY | VT_UI1))
                    {
                        hRet = SafeArrayAccessData(V_ARRAY(vSid),
                                                   (void **)&pSid);
                        if (FAILED(hRet))
                        {
                            break;
                        }

                        if (pSid != NULL)
                        {
                            contLoop = SelectedSidCallback(pDsObjectPicker,
                                                           hwndParent,
                                                           pSid,
                                                           Context);
                        }

                        SafeArrayUnaccessData(V_ARRAY(vSid));
                    }
                }

                GlobalUnlock(stm.hGlobal);

                if (SUCCEEDED(hRet))
                {
                    /* return S_OK instead of possible other success codes if
                       everything went well */
                    hRet = S_OK;
                }
            }
            else
            {
                /* unable to translate the selection pointer handle, indicate
                   failure */
                hRet = E_FAIL;
            }

            ReleaseStgMedium(&stm);
        }

        pdo->lpVtbl->Release(pdo);
    }

    return hRet;
}

Referenced by SecurityPageProc().

ListViewGetSelectedItemData()

LPARAM ListViewGetSelectedItemData

(

IN HWND

hwnd

)

Definition at line 134 of file misc.c.

{
    int Index;

    Index = ListView_GetNextItem(hwnd,
                                 -1,
                                 LVNI_SELECTED);
    if (Index != -1)
    {
        LVITEM li;

        li.mask = LVIF_PARAM;
        li.iItem = Index;
        li.iSubItem = 0;

        if (ListView_GetItem(hwnd,
                             &li))
        {
            return li.lParam;
        }
    }

    return 0;
}

ListViewSelectItem()

BOOL ListViewSelectItem	(	IN HWND	hwnd,
		IN INT	Index
	)

Definition at line 160 of file misc.c.

{
    LVITEM li;

    li.mask = LVIF_STATE;
    li.iItem = Index;
    li.iSubItem = 0;
    li.state = LVIS_SELECTED;
    li.stateMask = LVIS_SELECTED;

    return ListView_SetItem(hwnd,
                            &li);
}

Referenced by SecurityPageProc().

LoadAndFormatString()

DWORD LoadAndFormatString	(	IN HINSTANCE	hInstance,
		IN UINT	uID,
		OUT LPWSTR *	lpTarget,
			...
	)

Definition at line 76 of file misc.c.

{
    DWORD Ret = 0;
    LPWSTR lpFormat;
    va_list lArgs;

    if (AllocAndLoadString(&lpFormat,
                           hInstance,
                           uID) > 0)
    {
        va_start(lArgs, lpTarget);
        /* let's use Format to format it because it has the ability to allocate
           memory automatically */
        Ret = FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
                             lpFormat,
                             0,
                             0,
                             (LPWSTR)lpTarget,
                             0,
                             &lArgs);
        va_end(lArgs);

        LocalFree((HLOCAL)lpFormat);
    }

    return Ret;
}

LookupSidCache()

BOOL LookupSidCache	(	IN HANDLE	SidCacheMgr,
		IN PSID	pSid,
		IN PSIDREQCOMPLETIONPROC	CompletionProc,
		IN PVOID	Context
	)

Definition at line 876 of file sidcache.c.

{
    BOOL Found = FALSE;
    PSIDREQRESULT ReqResult = NULL;
    PSIDCACHEMGR scm;

    scm = ReferenceSidCacheMgr(SidCacheMgr);
    if (scm != NULL)
    {
        EnterCriticalSection(&scm->Lock);

        /* search the cache */
        Found = FindSidInCache(scm,
                               pSid,
                               &ReqResult);

        if (!Found)
        {
            /* the sid is not in the cache, queue it if not already queued */
            if (!QueueSidLookup(scm,
                                pSid,
                                CompletionProc,
                                Context))
            {
                PSIDREQRESULT FoundReqResult = NULL;

                /* unable to queue it, look it up now */

                LeaveCriticalSection(&scm->Lock);

                /* lookup everything we need */
                if (!LookupSidInformation(scm,
                                          pSid,
                                          &ReqResult))
                {
                    ReqResult = NULL;
                }

                EnterCriticalSection(&scm->Lock);

                /* see if the SID was added to the cache in the meanwhile */
                if (!FindSidInCache(scm,
                                    pSid,
                                    &FoundReqResult))
                {
                    if (ReqResult != NULL)
                    {
                        /* cache the results */
                        CacheLookupResults(scm,
                                           pSid,
                                           ReqResult);
                    }
                }
                else
                {
                    if (ReqResult != NULL)
                    {
                        /* free the information of our lookup and use the cached
                           information*/
                        DereferenceSidReqResult(scm,
                                                ReqResult);
                    }

                    ReqResult = FoundReqResult;
                }

                Found = (ReqResult != NULL);
            }
        }

        LeaveCriticalSection(&scm->Lock);

        /* call the completion callback */
        if (Found)
        {
            CompletionProc(SidCacheMgr,
                           pSid,
                           ReqResult,
                           Context);

            if (ReqResult != NULL)
            {
                HeapFree(scm->Heap,
                         0,
                         ReqResult);
            }
        }

        DereferenceSidCacheMgr(scm);
    }

    return Found;
}

Referenced by AddPrincipalToList(), and ReloadPrincipalsList().

ReferenceSidReqResult()

VOID ReferenceSidReqResult	(	IN HANDLE	SidCacheMgr,
		IN PSIDREQRESULT	ReqResult
	)

Definition at line 839 of file sidcache.c.

{
    PSIDCACHEMGR scm;

    scm = ReferenceSidCacheMgr(SidCacheMgr);
    if (scm != NULL)
    {
        InterlockedIncrement(&ReqResult->RefCount);

        DereferenceSidCacheMgr(scm);
    }
}

Referenced by UpdatePrincipalListItem().

RegisterCheckListControl()

BOOL RegisterCheckListControl

(

HINSTANCE

hInstance

)

UnregisterCheckListControl()

VOID UnregisterCheckListControl

(

HINSTANCE

hInstance

)

Definition at line 2614 of file checklist.c.

{
    UnregisterClass(szCheckListWndClass,
                    hInstance);
}

Referenced by DllMain().

Variable Documentation

hDllInstance

HINSTANCE hDllInstance

Definition at line 17 of file browser.c.