CFG_GetCertificateHashEntry

Setup and Configuration of Intel AMT > Setup and Configuration Methods > MEI Commands > CFG_GetCertificateHashEntry

CFG_GetCertificateHashEntry

CFG_GetCertificateHashEntry returns the CertHashEntry associated with the handle. The struct contains the hashed certificate array, the certificate's friendly name, its active state and its default state.

CFG_GetCertificateHashEntry Request

typedef struct _CFG_GET_CERTHASH_ENTRY_REQUEST

{

PTHI_MESSAGE_HEADER Header;

UINT32 Handle;

} CFG_GET_CERTHASH_ENTRY_REQUEST;

Field	Description
Header.Version	Major and minor interface version.
Header.Reserved	0000h
Header.Command	0400002Dh
Header.Length	Message Length, excluding the message header.
Handle	Reference handle to the certificate entry

CFG_GetCertificateHashEntry Response

typedef struct _CFG_GET_CERTHASH_ENTRY_RESPONSE

{

PTHI_MESSAGE_HEADER Header;

AMT_STATUS Status;

[success] AMT_BOOLEAN IsDefault;

[success] AMT_BOOLEAN IsActive;

[success] UINT8 CertificateHash[64];

[success] UINT8 HashAlgorithm;

[success] AMT_ANSI_STRING Name;

} CFG_GET_CERTHASH_ENTRY_RESPONSE;

Field	Description
Header.Version	Major and minor interface version.
Header.Reserved	0000h
Header.Command	0480002Dh
Header.Length	Message Length, excluding the message header.
Status	A status code returned in a response message that indicates whether the operation specified in the corresponding request message succeeded or failed. If the operation failed, this code indicates the specific reason for failure.
IsDefault	Is this a default certificate or not. FALSE – not a default; TRUE – default.
IsActive	Indicates whether this certificate active for provisioning. FALSE – not active; TRUE – active.
CertificateHash	Hashed certificate.
HashAlgorithm .	The algorithm used to create the certificate hash Possible values: 1 – CERT_HASH_ALGORITHM_SHA1 (20 bytes) 2 – CERT_HASH_ALGORITHM_SHA256 (32 bytes) From Release 6.0 only 3 – CERT_HASH_ALGORITHM_SHA384 (48 bytes) From Release 6.0 only
Name	ASCII character set, contains certificate friendly name which is up to 32 bytes.

CFG_GetCertificateHashEntry Status Codes

Status	Description
AMT_STATUS_SUCCESS	Request succeeded.
AMT_STATUS_INTERNAL_ERROR	An internal error in the Intel AMT device has occurred.
AMT_STATUS_NOT_READY	Management controller has not progressed far enough in its initialization to process the command.
AMT_STATUS_INVALID_MESSAGE_LENGTH	Length field of header is invalid.
AMT_STATUS_NOT_FOUND	No certificate with this handle.