HCRYPTKEY wrapper class. More...

#include <WinStd/Crypt.h>

Inheritance diagram for winstd::crypt_key:

Public Member Functions
virtual	~crypt_key ()
	Destroys the key. More...

	__declspec (deprecated("Use CryptGenKey")) bool generate(HCRYPTPROV hProv
	Generates the key. More...

	if (CryptGenKey(hProv, Algid, dwFlags, &h))

	__declspec (deprecated("Use CryptImportKey")) bool import(HCRYPTPROV hProv
	Imports the key. More...

	__in_bcount (dwDataLen) LPCBYTE pbData

	if (CryptImportKey(hProv, pbData, dwDataLen, hPubKey, dwFlags, &h))

	__declspec (deprecated("Use CryptImportPublicKeyInfo")) bool import_public(HCRYPTPROV hCryptProv
	Imports the public key. More...

	if (CryptImportPublicKeyInfo(hCryptProv, dwCertEncodingType, pInfo, &h))

	__declspec (deprecated("Use CryptDeriveKey")) bool derive(HCRYPTPROV hProv
	Generates cryptographic session keys derived from a base data value. More...

	if (CryptDeriveKey(hProv, Algid, hBaseData, dwFlags, &h))

bool	create_exp1 (HCRYPTPROV hProv, DWORD dwKeySpec)
	Creates Exponent-of-one key. More...

Public Member Functions inherited from winstd::dplhandle< HCRYPTKEY, NULL >
	dplhandle () noexcept
	Initializes a new class instance with the object handle set to INVAL.

	dplhandle (handle_type h) noexcept
	Initializes a new class instance with an already available object handle. More...

	dplhandle (const dplhandle< handle_type, INVAL > &h) noexcept
	Copy constructor. More...

	dplhandle (dplhandle< handle_type, INVAL > &&h) noexcept
	Move constructor. More...

dplhandle< handle_type, INVAL > &	operator= (handle_type h) noexcept
	Attaches already available object handle. More...

dplhandle< handle_type, INVAL > &	operator= (const dplhandle< handle_type, INVAL > &h) noexcept
	Duplicates the object. More...

dplhandle< handle_type, INVAL > &	operator= (dplhandle< handle_type, INVAL > &&h) noexcept
	Moves the object. More...

handle_type	duplicate () const
	Duplicates and returns a new object handle. More...

bool	attach_duplicated (handle_type h)
	Duplicates an object handle and sets a new object handle. More...

Public Member Functions inherited from winstd::handle< HCRYPTKEY, INVAL >
	handle () noexcept
	Initializes a new class instance with the object handle set to INVAL.

	handle (handle_type h) noexcept
	Initializes a new class instance with an already available object handle. More...

	handle (handle< handle_type, INVAL > &&h) noexcept
	Move constructor. More...

handle< handle_type, INVAL > &	operator= (handle_type h) noexcept
	Attaches already available object handle. More...

handle< handle_type, INVAL > &	operator= (handle< handle_type, INVAL > &&h) noexcept
	Move assignment. More...

	operator handle_type () const
	Auto-typecasting operator. More...

handle_type *&	operator* () const
	Returns the object handle value when the object handle is a pointer to a value (class, struct, etc.). More...

handle_type *	operator& ()
	Returns the object handle reference. More...

handle_type	operator-> () const
	Provides object handle member access when the object handle is a pointer to a class or struct. More...

bool	operator! () const
	Tests if the object handle is INVAL. More...

bool	operator< (handle_type h) const
	Is handle less than? More...

bool	operator<= (handle_type h) const
	Is handle less than or equal to? More...

bool	operator>= (handle_type h) const
	Is handle greater than or equal to? More...

bool	operator> (handle_type h) const
	Is handle greater than? More...

bool	operator!= (handle_type h) const
	Is handle not equal to? More...

bool	operator== (handle_type h) const
	Is handle equal to? More...

void	attach (handle_type h) noexcept
	Sets a new object handle for the class. More...

handle_type	detach ()
	Dismisses the object handle from this class. More...

void	free ()
	Destroys the object.

Public Attributes
ALG_ID	Algid

ALG_ID DWORD dwFlags	noexcept

else return	false

DWORD	dwDataLen

DWORD HCRYPTKEY	hPubKey

DWORD HCRYPTKEY DWORD dwFlags	noexcept

DWORD	dwCertEncodingType

DWORD PCERT_PUBLIC_KEY_INFO pInfo	noexcept

ALG_ID HCRYPTHASH	hBaseData

ALG_ID HCRYPTHASH DWORD dwFlags	noexcept

Protected Member Functions
void	free_internal () noexcept override
	Destroys the key. More...

handle_type	duplicate_internal (handle_type h) const noexcept override
	Duplicates the key. More...

virtual handle_type	duplicate_internal (handle_type h) const noexcept=0
	Abstract member function that must be implemented by child classes to do the actual object handle duplication. More...

virtual void	free_internal () noexcept=0
	Abstract member function that must be implemented by child classes to do the actual object destruction. More...

Additional Inherited Members
Public Types inherited from winstd::handle< HCRYPTKEY, INVAL >
typedef HCRYPTKEY	handle_type
	Datatype of the object handle this template class handles.

Static Public Attributes inherited from winstd::handle< HCRYPTKEY, INVAL >
static const HCRYPTKEY	invalid
	Invalid handle value.

Protected Attributes inherited from winstd::handle< HCRYPTKEY, INVAL >
handle_type	m_h
	Object handle.

Detailed Description

HCRYPTKEY wrapper class.

Constructor & Destructor Documentation

◆ ~crypt_key()

virtual winstd::crypt_key::~crypt_key ( )

inlinevirtual

Destroys the key.

See also: CryptDestroyKey function

Member Function Documentation

◆ __declspec() [1/4]

winstd::crypt_key::__declspec ( deprecated("Use CryptDeriveKey") )

Generates cryptographic session keys derived from a base data value.

See also: CryptDeriveKey function

◆ __declspec() [2/4]

winstd::crypt_key::__declspec ( deprecated("Use CryptGenKey") )

Generates the key.

See also: CryptGenKey function

◆ __declspec() [3/4]

winstd::crypt_key::__declspec ( deprecated("Use CryptImportKey") )

Imports the key.

See also: CryptImportKey function

◆ __declspec() [4/4]

winstd::crypt_key::__declspec ( deprecated("Use CryptImportPublicKeyInfo") )

Imports the public key.

See also: CryptImportPublicKeyInfo function

◆ create_exp1()

bool winstd::crypt_key::create_exp1	(	HCRYPTPROV	hProv,
		DWORD	dwKeySpec
	)

inline

Creates Exponent-of-one key.

See also: How to export and import plain text session keys by using CryptoAPI

Parameters

[in]	hProv	Handle of cryptographics provider to use
[in]	dwKeySpec	Key specification (`AT_KEYEXCHANGE` or `AT_SIGNATURE`)

◆ duplicate_internal()

handle_type winstd::crypt_key::duplicate_internal ( handle_type h ) const

inlineoverrideprotectedvirtualnoexcept

Duplicates the key.

Parameters

[in] h Object handle of existing key

Returns: Duplicated key handle

See also: CryptDuplicateKey function

Implements winstd::dplhandle< HCRYPTKEY, NULL >.

◆ free_internal()

void winstd::crypt_key::free_internal ( )

inlineoverrideprotectedvirtualnoexcept

Destroys the key.

See also: CryptDestroyKey function

Implements winstd::handle< HCRYPTKEY, INVAL >.

Member Data Documentation

◆ noexcept [1/4]

ALG_ID DWORD dwFlags winstd::crypt_key::noexcept

Initial value:

{

handle_type h

winstd::handle< HCRYPTKEY, INVAL >::handle_type

HCRYPTKEY handle_type

Datatype of the object handle this template class handles.

Definition: Common.h:608

◆ noexcept [2/4]

DWORD HCRYPTKEY DWORD dwFlags winstd::crypt_key::noexcept

Initial value:

{

handle_type h

◆ noexcept [3/4]

DWORD PCERT_PUBLIC_KEY_INFO pInfo winstd::crypt_key::noexcept

Initial value:

{

handle_type h

◆ noexcept [4/4]

ALG_ID HCRYPTHASH DWORD dwFlags winstd::crypt_key::noexcept

Initial value:

{

handle_type h

The documentation for this class was generated from the following file:

include/WinStd/Crypt.h

Public Member Functions

Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~crypt_key()

Member Function Documentation

◆ __declspec() [1/4]

◆ __declspec() [2/4]

◆ __declspec() [3/4]

◆ __declspec() [4/4]

◆ create_exp1()

◆ duplicate_internal()

◆ free_internal()

Member Data Documentation

◆ noexcept [1/4]

◆ noexcept [2/4]

◆ noexcept [3/4]

◆ noexcept [4/4]