Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6ICryptoKeyGetMeta::getUse ( P6WCHAR pUse,
P6UINT32  cBuffer,
P6UINT32 pWritten 
)
pure virtual

This method retrieves the human or machine readable description on how key is to be used (e.g., sign SSH packages) (see reference 1).

Parameters
pUse[IN] Block of memory to write information on how the key is to be used into. If NULL then, the required size of this buffer is returned in pWritten.
cBuffer[IN] Number of characters in the buffer pointed to by pUse.
pWritten[OUT] Optional can be NULL, returns the number of characters written into pUse. This parameter cannot be NULL when pUse is also NULL.
Returns
SuccessP6R::eOk 
FailureP6R::eNotInitializedObject is in an incorrect state.
P6R::eInvalidArgpUse and pWritten are NULL.
P6R::eNotFoundThe requested meta data is not defined
P6R::eTooBigThe requested value is too big to fit into pUse.