tspi_context_getkeybypublicinfo(3) - Linux man page
Name
Tspi_Context_GetKeyByPublicInfo - search the persistent storage for a registered key using the provided public key information
Synopsis
#include <tss/platform.h>
#include <tss/tcpa_defines.h>
#include <tss/tcpa_typedef.h>
#include <tss/tcpa_struct.h>
#include <tss/tss_typedef.h>
#include <tss/tss_structs.h>
#include <tss/tspi.h>
TSS_RESULT Tspi_Context_GetKeyByPublicInfo(TSS_HCONTEXT hContext, TSS_FLAG persistentStorageType,
TSS_ALGORITHM_ID algID, UINT32 ulPublicInfoLength,
BYTE* rgbPublicInfo, TSS_HKEY* phKey);
Description
TSS_Context_GetKeyByPublicInfo searches the persistent storage for a registered key using the provided public key information and creates a key object initalized according to the found data. On successful completion of the method a handle to the created new key object is returned.
Parameters
hContext
- The handle of the context object.
persistentStorageType
- Flag indicating the persistent storage the key is registered in.
algId
- This parameter indicates the algorithm of the requested key.
ulPublicInfoLength
- The length of the public key info provided at the parameter rgbPublicInfo.
rgbPublicInfo
- The public key info is provided to identify the key to be look for at the persistent storage. In case algID equals to TSS_ALG_RSA this prameter contains the modulus of the public RSA key.
hKey
- Recieves the handle of the key object representing the key. In case the key hasn't been found, this value will be NULL.
Return Codes
Tspi_Context_GetKeyByPublicInfo returns TSS_SUCCESS on success, otherwise one of the following values are returned:
- TSS_E_INVALID_HANDLE - hContext is an invalid handle.
- TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
Conforming To
Tspi_Context_GetKeyByPublicInfo conforms to the Trusted Computing Group Software Specification version 1.1 Golden
See Also
tspi_context_loadkeybyuuid(3).