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

NAME

8       Tspi_Hash_VerifySignature  -  verify the hash value with a given signa‐
9       ture
10

SYNOPSIS

12       #include <tss/platform.h>
13       #include <tss/tcpa_defines.h>
14       #include <tss/tcpa_typedef.h>
15       #include <tss/tcpa_struct.h>
16       #include <tss/tss_typedef.h>
17       #include <tss/tss_structs.h>
18       #include <tss/tspi.h>
19
20       TSS_RESULT Tspi_Hash_VerifySignature(TSS_HHASH hHash,             TSS_HKEY hKey,
21                                            UINT32    ulSignatureLength, BYTE*    rgbSignature);
22
23
24

DESCRIPTION

26       Tspi_Hash_VerifySignature verifies the hash value of a given  hash  ob‐
27       ject  with  a  given  signature. In order to use this command, one must
28       have a hash and a signature of the hash that one is trying  to  verify.
29       The  public  key  which corresponds to the private key used to sign the
30       hash is also needed.
31
32

PARAMETERS

34   hHash
35       The handle to the hash object  instance  whose  hash  value  should  be
36       signed.
37
38   hKey
39       Handle to the key object which should be used for the signature verifi‐
40       cation.
41
42   ulSignatureLength
43       The length of the signature data provided at  the  parameter  rgbSigna‐
44       ture.
45
46   rgbSignature
47       A pointer to the signature data.
48
49

RETURN CODES

51       Tspi_Hash_VerifySignature returns TSS_SUCCESS on success, otherwise one
52       of the following values is returned:
53
54       TSS_E_INVALID_HANDLE
55              hKey is not a valid handle.
56
57
58       TSS_E_INTERNAL_ERROR
59              An internal SW error has been detected.
60
61
62       TSS_E_BAD_PARAMETER
63              One or more parameters is bad.
64
65
66       TSS_E_HASH_INVALID_LENGTH
67              Hash length is inconsistent with hash algorithm.
68
69
70       TSS_E_HASH_NO_DATA
71              Hash object has no internal hash value.
72
73
74       TSS_E_INVALID_SIGSCHEME
75              Invalid signature scheme.
76
77
78

CONFORMING TO

80       Tspi_Hash_VerifySignature conforms to the Trusted Computing Group Soft‐
81       ware Specification version 1.1 Golden
82
83

SEE ALSO

85       Tspi_Hash_UpdateHashValue(3),                Tspi_Hash_SetHashValue(3),
86       Tspi_Hash_Sign(3), Tspi_Hash_GetHashValue(3).
87
88
89
90
91TSS 1.1                           2004-05-25      Tspi_Hash_VerifySignature(3)
Impressum