Intel Extensible Firmware Interface Network Router User Manual


  Open as PDF
of 1084
 
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 callers 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 platforms 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.