handle.h File Reference

#include <wincrypt.h>

Include dependency graph for handle.h:

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

Go to the source code of this file.

Classes
struct	tagOBJECTHDR
struct	handle_table_entry
struct	handle_table

Macros
#define	TABLE_SIZE_INCREMENT   32

Typedefs
typedef struct tagOBJECTHDR	OBJECTHDR
typedef void(*	DESTRUCTOR) (OBJECTHDR *object)

Functions
void	init_handle_table (struct handle_table *lpTable) DECLSPEC_HIDDEN
void	destroy_handle_table (struct handle_table *lpTable) DECLSPEC_HIDDEN
BOOL	release_handle (struct handle_table *lpTable, HCRYPTKEY handle, DWORD dwType) DECLSPEC_HIDDEN
BOOL	copy_handle (struct handle_table *lpTable, HCRYPTKEY handle, DWORD dwType, HCRYPTKEY *copy) DECLSPEC_HIDDEN
BOOL	lookup_handle (struct handle_table *lpTable, HCRYPTKEY handle, DWORD dwType, OBJECTHDR **lplpObject) DECLSPEC_HIDDEN
BOOL	is_valid_handle (struct handle_table *lpTable, HCRYPTKEY handle, DWORD dwType) DECLSPEC_HIDDEN
HCRYPTKEY	new_object (struct handle_table *lpTable, size_t cbSize, DWORD dwType, DESTRUCTOR destructor, OBJECTHDR **ppObject) DECLSPEC_HIDDEN

Macro Definition Documentation

TABLE_SIZE_INCREMENT

#define TABLE_SIZE_INCREMENT   32

Definition at line 33 of file handle.h.

Typedef Documentation

DESTRUCTOR

typedef void(* DESTRUCTOR) (OBJECTHDR *object)

Definition at line 37 of file handle.h.

OBJECTHDR

typedef struct tagOBJECTHDR OBJECTHDR

Definition at line 36 of file handle.h.

Function Documentation

copy_handle()

BOOL copy_handle	(	struct handle_table *	lpTable,
		HCRYPTKEY	handle,
		DWORD	dwType,
		HCRYPTKEY *	copy
	)

Definition at line 310 of file handle.c.

{
    OBJECTHDR *pObject;
    BOOL ret;
 
    TRACE("(lpTable=%p, handle=%ld, copy=%p)\n", lpTable, handle, copy);
 
    EnterCriticalSection(&lpTable->mutex);
    if (!lookup_handle(lpTable, handle, dwType, &pObject)) 
    {
        *copy = (HCRYPTKEY)INVALID_HANDLE_VALUE;
        LeaveCriticalSection(&lpTable->mutex);
        return FALSE;
    }
 
    ret = alloc_handle(lpTable, pObject, copy);
    LeaveCriticalSection(&lpTable->mutex);
    return ret;
}

Referenced by release_and_install_key(), and RSAENH_CPGetUserKey().

destroy_handle_table()

void destroy_handle_table

(

struct handle_table *

lpTable

)

Definition at line 72 of file handle.c.

{
    TRACE("(lpTable=%p)\n", lpTable);
        
    HeapFree(GetProcessHeap(), 0, lpTable->paEntries);
    lpTable->mutex.DebugInfo->Spare[0] = 0;
    DeleteCriticalSection(&lpTable->mutex);
}

Referenced by DllMain().

init_handle_table()

void init_handle_table

(

struct handle_table *

lpTable

)

Definition at line 53 of file handle.c.

{
    TRACE("(lpTable=%p)\n", lpTable);
        
    lpTable->paEntries = NULL;
    lpTable->iEntries = 0;
    lpTable->iFirstFree = 0;
    InitializeCriticalSection(&lpTable->mutex);
    lpTable->mutex.DebugInfo->Spare[0] = (DWORD_PTR)(__FILE__ ": HANDLETABLE.mutex");
}

Referenced by DllMain().

is_valid_handle()

BOOL is_valid_handle	(	struct handle_table *	lpTable,
		HCRYPTKEY	handle,
		DWORD	dwType
	)

Definition at line 96 of file handle.c.

{
    unsigned int index = HANDLE2INDEX(handle);
    BOOL ret = FALSE;
 
    TRACE("(lpTable=%p, handle=%ld)\n", lpTable, handle);
    
    EnterCriticalSection(&lpTable->mutex);
        
    /* We don't use zero handle values */
    if (!handle) goto exit;
 
    /* Check for index out of table bounds */    
    if (index >= lpTable->iEntries) goto exit;
    
    /* Check if this handle is currently allocated */
    if (!lpTable->paEntries[index].pObject) goto exit;
    
    /* Check if this handle references an object of the correct type. */
    if (lpTable->paEntries[index].pObject->dwType != dwType) goto exit;
 
    ret = TRUE;
exit:
    LeaveCriticalSection(&lpTable->mutex);
    return ret;
}

Referenced by crypt_export_key(), lookup_handle(), release_handle(), RSAENH_CPDecrypt(), RSAENH_CPDeriveKey(), RSAENH_CPDestroyHash(), RSAENH_CPDestroyKey(), RSAENH_CPDuplicateHash(), RSAENH_CPDuplicateKey(), RSAENH_CPEncrypt(), RSAENH_CPExportKey(), RSAENH_CPGenRandom(), RSAENH_CPGetHashParam(), RSAENH_CPGetKeyParam(), RSAENH_CPSetHashParam(), RSAENH_CPSetKeyParam(), and RSAENH_CPVerifySignature().

lookup_handle()

BOOL lookup_handle	(	struct handle_table *	lpTable,
		HCRYPTKEY	handle,
		DWORD	dwType,
		OBJECTHDR **	lplpObject
	)

Definition at line 275 of file handle.c.

{
    BOOL ret = FALSE;
 
    TRACE("(lpTable=%p, handle=%ld, lplpObject=%p)\n", lpTable, handle, lplpObject);
    
    EnterCriticalSection(&lpTable->mutex);
    if (!is_valid_handle(lpTable, handle, dwType)) 
    {
        *lplpObject = NULL;
        goto exit;
    }
    *lplpObject = lpTable->paEntries[HANDLE2INDEX(handle)].pObject;
 
    ret = TRUE;
exit:
    LeaveCriticalSection(&lpTable->mutex);
    return ret;
}

Referenced by copy_handle(), crypt_export_key(), get_key_container(), import_symmetric_key(), read_key_container(), read_key_value(), RSAENH_CPCreateHash(), RSAENH_CPDecrypt(), RSAENH_CPDeriveKey(), RSAENH_CPDuplicateHash(), RSAENH_CPDuplicateKey(), RSAENH_CPEncrypt(), RSAENH_CPExportKey(), RSAENH_CPGetHashParam(), RSAENH_CPGetKeyParam(), RSAENH_CPHashData(), RSAENH_CPHashSessionKey(), RSAENH_CPSetHashParam(), RSAENH_CPSetKeyParam(), RSAENH_CPSignHash(), RSAENH_CPVerifySignature(), store_key_pair(), store_key_permissions(), tls1_p(), and tls1_prf().

new_object()

HCRYPTKEY new_object	(	struct handle_table *	lpTable,
		size_t	cbSize,
		DWORD	dwType,
		DESTRUCTOR	destructor,
		OBJECTHDR **	ppObject
	)

Definition at line 353 of file handle.c.

{
    OBJECTHDR *pObject;
    HCRYPTKEY hObject;
 
    if (ppObject)
        *ppObject = NULL;
 
    pObject = HeapAlloc(GetProcessHeap(), 0, cbSize);
    if (!pObject)
        return (HCRYPTKEY)INVALID_HANDLE_VALUE;
 
    pObject->dwType = dwType;
    pObject->refcount = 0;
    pObject->destructor = destructor;
 
    if (!alloc_handle(lpTable, pObject, &hObject))
        HeapFree(GetProcessHeap(), 0, pObject);
    else
        if (ppObject)
            *ppObject = pObject;
 
    return hObject;
}

Referenced by new_key(), new_key_container(), RSAENH_CPCreateHash(), RSAENH_CPDuplicateHash(), RSAENH_CPDuplicateKey(), and StorageImpl_Refresh().

release_handle()

BOOL release_handle	(	struct handle_table *	lpTable,
		HCRYPTKEY	handle,
		DWORD	dwType
	)

Definition at line 230 of file handle.c.

{
    unsigned int index = HANDLE2INDEX(handle);
    OBJECTHDR *pObject;
    BOOL ret = FALSE;
 
    TRACE("(lpTable=%p, handle=%ld)\n", lpTable, handle);
    
    EnterCriticalSection(&lpTable->mutex);
    
    if (!is_valid_handle(lpTable, handle, dwType))
        goto exit;
 
    pObject = lpTable->paEntries[index].pObject;
    if (InterlockedDecrement(&pObject->refcount) == 0)
    {
        TRACE("destroying handle %ld\n", handle);
        if (pObject->destructor)
            pObject->destructor(pObject);
    }
 
    lpTable->paEntries[index].pObject = NULL;
    lpTable->paEntries[index].iNextFree = lpTable->iFirstFree;
    lpTable->iFirstFree = index;
 
    ret = TRUE;
exit:
    LeaveCriticalSection(&lpTable->mutex);
    return ret;
}

Referenced by import_plaintext_key(), read_key_container(), release_key_container_keys(), RSAENH_CPAcquireContext(), RSAENH_CPDestroyHash(), RSAENH_CPDestroyKey(), RSAENH_CPReleaseContext(), and tls1_prf().