tspi_hash_gethashvalue(3) - Linux man page
TCG Software Stack Developer's Reference
Name
Tspi_Hash_GetHashValue - get the current hash value of a hash object
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_Hash_GetHashValue(TSS_HHASH hHash, UINT32* pulHashValueLength, BYTE** prgbHashValue);
Description
Tspi_Hash_GetHashValue gets the hash value of a hash object. Tspi_Context_FreeMemory must be used to clean up after this function, as memory is allocated for the prgbHashValue data.
Parameters
hHash
- The handle to the hash object instance whose hash value should be signed.
pulHashValueLength
- Receives the length of the hash value data returned at the parameter prgbHashValue.
prgbHashValue
- Receives a pointer to the hash value data.
Return Codes
Tspi_Hash_GetHashValue returns TSS_SUCCESS on success, otherwise one of the following values is returned:
- TSS_E_INVALID_HANDLE
- hHash is not a valid handle.
- TSS_E_INTERNAL_ERROR
- An internal SW error has been detected.
- TSS_E_BAD_PARAMETER
- One or more parameters is bad.
- TSS_E_HASH_INVALID_LENGTH
- Hash length is inconsistent with hash algorithm.
- TSS_E_HASH_NO_DATA
- Hash object has no internal hash value.
Conforming To
Tspi_Hash_GetHashValue conforms to the Trusted Computing Group Software Specification version 1.1 Golden
See Also
Tspi_Hash_UpdateHash(3), tspi_hash_sign(3), tspi_hash_verifysignature(3), tspi_hash_sethashvalue(3).