Intel Extensible Firmware Interface - Manual (Page 685)

Protocols — Network Support
Version 1.10 12/01/02 15-79
EFI_BIS.GetBootObjectAuthorizationCertificate()
Summary
Retrieves the certificate that has been configured as the identity of the organization designated as
the source of authorization for signatures of boot objects.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_BIS_GET_BOOT_OBJECT_AUTHORIZATION_CERTIFICATE)(
IN BIS_APPLICATION_HANDLE
AppHandle,
OUT EFI_BIS_DATA **Certificate
);
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.
Certificate The function writes an allocated EFI_BIS_DATA* containing the Boot
Object Authorization Certificate object. 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.
Description
This function retrieves the certificate that has been configured as the identity of the organization
designated as the source of authorization for signatures of boot objects.
Status Codes Returned
EFI_SUCCESS The function completed successfully.
EFI_NO_MAPPING The AppHandle parameter is not or is no longer a valid
application instance handle associated with the EFI_BIS protocol.
EFI_NOT_FOUND There is no Boot Object Authorization Certificate currently installed.
EFI_OUT_OF_RESOURCES The function failed due to lack of memory or other resources.
EFI_INVALID_PARAMETER The Certificate parameter supplied by the caller is NULL or
an invalid memory reference.