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.

Copyright © 2006-2022, Intel Corporation. All rights reserved.