1Tspi_Hash_GetHashValue(3)  Library Functions Manual  Tspi_Hash_GetHashValue(3)
2
3
4
5                   TCG Software Stack Developer's Reference
6

NAME

8       Tspi_Hash_GetHashValue - get the current hash value of a hash object
9

SYNOPSIS

11       #include <tss/platform.h>
12       #include <tss/tcpa_defines.h>
13       #include <tss/tcpa_typedef.h>
14       #include <tss/tcpa_struct.h>
15       #include <tss/tss_typedef.h>
16       #include <tss/tss_structs.h>
17       #include <tss/tspi.h>
18
19       TSS_RESULT Tspi_Hash_GetHashValue(TSS_HHASH hHash, UINT32* pulHashValueLength, BYTE** prgbHashValue);
20
21
22

DESCRIPTION

24       Tspi_Hash_GetHashValue  gets the hash value of a hash object. Tspi_Con‐
25       text_FreeMemory must be used to clean up after this function, as memory
26       is allocated for the prgbHashValue data.
27
28

PARAMETERS

30   hHash
31       The  handle  to  the  hash  object  instance whose hash value should be
32       signed.
33
34   pulHashValueLength
35       Receives the length of the hash value data returned  at  the  parameter
36       prgbHashValue.
37
38   prgbHashValue
39       Receives a pointer to the hash value data.
40
41

RETURN CODES

43       Tspi_Hash_GetHashValue returns TSS_SUCCESS on success, otherwise one of
44       the following values is returned:
45
46       TSS_E_INVALID_HANDLE
47              hHash is not a valid handle.
48
49
50       TSS_E_INTERNAL_ERROR
51              An internal SW error has been detected.
52
53
54       TSS_E_BAD_PARAMETER
55              One or more parameters is bad.
56
57
58       TSS_E_HASH_INVALID_LENGTH
59              Hash length is inconsistent with hash algorithm.
60
61
62       TSS_E_HASH_NO_DATA
63              Hash object has no internal hash value.
64
65
66

CONFORMING TO

68       Tspi_Hash_GetHashValue conforms to the Trusted Computing Group Software
69       Specification version 1.1 Golden
70
71

SEE ALSO

73       Tspi_Hash_UpdateHash(3),    Tspi_Hash_Sign(3),   Tspi_Hash_VerifySigna‐
74       ture(3), Tspi_Hash_SetHashValue(3).
75
76
77
78
79TSS 1.1                           2004-05-25         Tspi_Hash_GetHashValue(3)
Impressum