tspi.h

可信计算 TPM 很重要的应用底层接口封装中间层 IBM资深人员开发

#if !defined( _TSPI_H_ )
#define _TSPI_H_


#if !defined( EXTERN_C )
#if defined ( __cplusplus )
#define EXTERN_C extern "C"
#else
#define EXTERN_C
#endif //__cplusplus
#endif //EXTERN_C

#if !defined( TSPICALL )
#define TSPICALL EXTERN_C TSS_RESULT
#endif //TSPICALL

TSPICALL Tspi_SetAttribUint32
(
 TSS_HOBJECT      hObject,      // in
 TSS_FLAG         attribFlag,   // in
 TSS_FLAG         subFlag,      // in
 UINT32           ulAttrib      // in
);

TSPICALL Tspi_GetAttribUint32
(
 TSS_HOBJECT      hObject,     // in
 TSS_FLAG         attribFlag,  // in
 TSS_FLAG         subFlag,     // in
 UINT32*          pulAttrib    // out
);

TSPICALL Tspi_SetAttribData
(
 TSS_HOBJECT      hObject,            // in
 TSS_FLAG         attribFlag,         // in
 TSS_FLAG         subFlag,            // in
 UINT32           ulAttribDataSize,   // in
 BYTE*            rgbAttribData       // in
);

TSPICALL Tspi_GetAttribData
(
 TSS_HOBJECT      hObject,               // in
 TSS_FLAG         attribFlag,            // in
 TSS_FLAG         subFlag,               // in
 UINT32*          pulAttribDataSize,     // out
 BYTE**           prgbAttribData         // out
);


TSPICALL Tspi_ChangeAuth
(
 TSS_HOBJECT      hObjectToChange,   // in
 TSS_HOBJECT      hParentObject,     // in
 TSS_HPOLICY      hNewPolicy         // in
);


TSPICALL Tspi_ChangeAuthAsym
(
 TSS_HOBJECT      hObjectToChange,   // in
 TSS_HOBJECT      hParentObject,     // in
 TSS_HKEY         hIdentKey,         // in
 TSS_HPOLICY      hNewPolicy         // in
);

TSPICALL Tspi_GetPolicyObject
(
 TSS_HOBJECT      hObject,      // in
 TSS_FLAG         policyType,   // in
 TSS_HPOLICY*     phPolicy      // out
);


TSPICALL Tspi_Context_Create
(
 TSS_HCONTEXT*    phContext   // out
);

TSPICALL Tspi_Context_Close
(
 TSS_HCONTEXT     hContext    // in
);


TSPICALL Tspi_Context_Connect
(
 TSS_HCONTEXT     hContext,        // in
 UNICODE*         wszDestination   // in
);

TSPICALL Tspi_Context_FreeMemory
(
 TSS_HCONTEXT     hContext,    // in
 BYTE*            rgbMemory    // in
);


TSPICALL Tspi_Context_GetDefaultPolicy
(
 TSS_HCONTEXT     hContext,    // in
 TSS_HPOLICY*     phPolicy     // out
);

TSPICALL Tspi_Context_CreateObject
(
 TSS_HCONTEXT     hContext,     // in
 TSS_FLAG         objectType,   // in
 TSS_FLAG         initFlags,    // in
 TSS_HOBJECT*     phObject      // out
);

TSPICALL Tspi_Context_CloseObject
(
 TSS_HCONTEXT     hContext,    // in
 TSS_HOBJECT      hObject      // in
);

TSPICALL Tspi_Context_GetCapability
(
 TSS_HCONTEXT     hContext,            // in
 TSS_FLAG         capArea,             // in
 UINT32           ulSubCapLength,      // in
 BYTE*            rgbSubCap,           // in
 UINT32*          pulRespDataLength,   // out
 BYTE**           prgbRespData         // out
);


TSPICALL Tspi_Context_GetTpmObject
(
 TSS_HCONTEXT     hContext,     // in
 TSS_HTPM*        phTPM         // out
);

TSPICALL Tspi_Context_LoadKeyByBlob
(
 TSS_HCONTEXT     hContext,         // in
 TSS_HKEY         hUnwrappingKey,   // in
 UINT32           ulBlobLength,     // in
 BYTE*            rgbBlobData,      // in
 TSS_HKEY*        phKey             // out
);


TSPICALL Tspi_Context_LoadKeyByUUID
(
 TSS_HCONTEXT     hContext,                // in
 TSS_FLAG         persistentStorageType,   // in
 TSS_UUID         uuidData,                // in
 TSS_HKEY*        phKey                    // out
);

TSPICALL Tspi_Context_RegisterKey
(
 TSS_HCONTEXT     hContext,                      // in
 TSS_HKEY         hKey,                          // in
 TSS_FLAG         persistentStorageType,         // in
 TSS_UUID         uuidKey,                       // in
 TSS_FLAG         persistentStorageTypeParent,   // in
 TSS_UUID         uuidParentKey                  // in
);

TSPICALL Tspi_Context_UnregisterKey
(
 TSS_HCONTEXT     hContext,                // in
 TSS_FLAG         persistentStorageType,   // in
 TSS_UUID         uuidKey,                 // in
 TSS_HKEY*	  phkey			   // out
);

TSPICALL Tspi_Context_GetKeyByUUID
(
 TSS_HCONTEXT     hContext,                // in
 TSS_FLAG         persistentStorageType,   // in
 TSS_UUID         uuidData,                // in
 TSS_HKEY*        phKey                    // out
);

TSPICALL Tspi_Context_GetKeyByPublicInfo
(
 TSS_HCONTEXT     hContext,                // in
 TSS_FLAG         persistentStorageType,   // in
 TSS_ALGORITHM_ID algID,                   // in
 UINT32           ulPublicInfoLength,      // in
 BYTE*            rgbPublicInfo,           // in
 TSS_HKEY*        phKey                    // out
);

TSPICALL Tspi_Context_GetRegisteredKeysByUUID
(
 TSS_HCONTEXT     hContext,                // in
 TSS_FLAG         persistentStorageType,   // in
 TSS_UUID*        pGuidData,               // in
 UINT32*          pulKeyHierarchySize,     // out
 TSS_KM_KEYINFO** ppKeyHierarchy           // out
);

TSPICALL Tspi_Policy_SetSecret
(
 TSS_HPOLICY      hPolicy,           // in
 TSS_FLAG         secretMode,        // in
 UINT32           ulSecretLength,    // in
 BYTE*            rgbSecret          // in
);

TSPICALL Tspi_Policy_FlushSecret
(
 TSS_HPOLICY      hPolicy    // in
);

TSPICALL Tspi_Policy_AssignToObject
(
 TSS_HPOLICY      hPolicy,   // in
 TSS_HOBJECT      hObject    // in
);

TSPICALL Tspi_TPM_CreateEndorsementKey
(
 TSS_HTPM         hTPM,               // in
 TSS_HKEY         hKey,               // in
 TSS_VALIDATION*  pValidationData     // in, out
);

TSPICALL Tspi_TPM_GetPubEndorsementKey
(
 TSS_HTPM         hTPM,                  // in
 TSS_BOOL         fOwnerAuthorized,      // in
 TSS_VALIDATION*  pValidationData,       // in, out
 TSS_HKEY*        phEndorsementPubKey    // out
);

TSPICALL Tspi_TPM_TakeOwnership
(
 TSS_HTPM         hTPM,                  // in
 TSS_HKEY         hKeySRK,               // in
 TSS_HKEY         hEndorsementPubKey     // in
);


TSPICALL Tspi_TPM_CollateIdentityRequest
(
 TSS_HTPM         hTPM,                       // in
 TSS_HKEY         hKeySRK,                    // in
 TSS_HKEY         hCAPubKey,                  // in
 UINT32           ulIdentityLabelLength,      // in
 BYTE*            rgbIdentityLabelData,       // in
 TSS_HKEY         hIdentityKey,               // in
 TSS_ALGORITHM_ID algid,				// in
 UINT32*          pulTcpaIdentityReqLength,   // out
 BYTE**           prgbTcpaIdentityReq         // out
);


TSPICALL Tspi_TPM_ActivateIdentity
(
 TSS_HTPM         hTPM,                         // in
 TSS_HKEY         hIdentKey,                    // in
 UINT32           ulAsymCAContentsBlobLength,   // in
 BYTE*            rgbAsymCAContentsBlob,        // in
 UINT32           ulSymCAAttestationBlobLength, // in
 BYTE*            rgbSymCAAttestationBlob,      // in
 UINT32*          pulCredentialLength,          // out
 BYTE**           prgbCredential                // out
);


TSPICALL Tspi_TPM_ClearOwner
(
 TSS_HTPM         hTPM,            // in
 TSS_BOOL         fForcedClear     // in
);


TSPICALL Tspi_TPM_SetStatus
(
 TSS_HTPM         hTPM,         // in
 TSS_FLAG         statusFlag,   // in
 TSS_BOOL         fTpmState     // in
);

TSPICALL Tspi_TPM_GetStatus
(
 TSS_HTPM         hTPM,         // in
 TSS_FLAG         statusFlag,   // in
 TSS_BOOL*        pfTpmState    // out
);

TSPICALL Tspi_TPM_SelfTestFull
(
 TSS_HTPM         hTPM   // in
);

TSPICALL Tspi_TPM_CertifySelfTest
(
 TSS_HTPM         hTPM,               // in
 TSS_HKEY         hKey,               // in
 TSS_VALIDATION*  pValidationData     // in, out
);

TSPICALL Tspi_TPM_GetTestResult
(
 TSS_HTPM         hTPM,                  // in
 UINT32*          pulTestResultLength,   // out
 BYTE**           prgbTestResult         // out
);

TSPICALL Tspi_TPM_GetCapability
(
 TSS_HTPM         hTPM,                // in
 TSS_FLAG         capArea,             // in
 UINT32           ulSubCapLength,      // in
 BYTE*            rgbSubCap,           // in
 UINT32*          pulRespDataLength,   // out
 BYTE**           prgbRespData         // out
);

TSPICALL Tspi_TPM_GetCapabilitySigned
(
 TSS_HTPM         hTPM,                // in
 TSS_HTPM         hKey,                // in
 TSS_FLAG         capArea,             // in
 UINT32           ulSubCapLength,      // in
 BYTE*            rgbSubCap,           // in
 TSS_VALIDATION*  pValidationData,     // in, out
 UINT32*          pulRespDataLength,   // out
 BYTE**           prgbRespData         // out
);

TSPICALL Tspi_TPM_CreateMaintenanceArchive
(
 TSS_HTPM         hTPM,                   // in
 TSS_BOOL         fGenerateRndNumber,     // in
 UINT32*          pulRndNumberLength,     // out
 BYTE**           prgbRndNumber,          // out
 UINT32*          pulArchiveDataLength,   // out
 BYTE**           prgbArchiveData         // out
);

TSPICALL Tspi_TPM_KillMaintenanceFeature
(
 TSS_HTPM         hTPM    // in
);

TSPICALL Tspi_TPM_LoadMaintenancePubKey
(