Intel Extensible Firmware Interface - Manual (Page 688)

Extensible Firmware Interface Specification
15-82 12/01/02 Version 1.10
EFI_BIS.GetSignatureInfo()
Summary
Retrieves a list of digital certificate identifier, digital signature algorithm, hash algorithm, and key-
length combinations that the platform supports.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_BIS_GET_SIGNATURE_INFO)(
IN BIS_APPLICATION_HANDLE
AppHandle,
OUT EFI_BIS_DATA **SignatureInfo
);
Parameters
AppHandle An opaque handle that identifies the caller’s instance of initialization of
the BIS service. Type
BIS_APPLICATION_HANDLE is defined in the
Initialize() function description.
SignatureInfo
The function writes an allocated
EFI_BIS_DATA* containing the array
of EFI_BIS_SIGNATURE_INFO structures representing the supported
digital certificate identifier, algorithm, and key length combinations. The
caller must eventually free the memory allocated by this function using
the function
Free() . Type EFI_BIS_DATA is defined in the
Initialize() function description. Type
EFI_BIS_SIGNATURE_INFO is defined in “Related Definitions”
below.
Related Definitions
//*******************************************************
// EFI_BIS_SIGNATURE_INFO
//*******************************************************
typedef struct _EFI_BIS_SIGNATURE_INFO {
BIS_CERT_ID
CertificateID;
BIS_ALG_ID AlgorithmID;
UINT16 KeyLength;
} EFI_BIS_SIGNATURE_INFO;
CertificateID A shortened value identifying the platform’s currently configured Boot
Object Authorization Certificate, if one is currently configured. The
shortened value is derived from the certificate as defined in the Related
Definition for
BIS_CERT_ID below. If there is no certificate currently
configured, the value is one of the reserved BIS_CERT_ID_XXX values
defined below. Type BIS_CERT_ID and its predefined reserved values
are defined in “Related Definitions” below.