beautypg.com

Uninstallmultipleprotocolinterfaces() – Intel Extensible Firmware Interface User Manual

Page 173

background image

Services — Boot Services

Version 1.10

12/01/02

5-75

UninstallMultipleProtocolInterfaces()

Summary

Removes one or more protocol interfaces into the boot services environment.

Prototype

typedef
EFI_STATUS
UninstallMultipleProtocolInterfaces (

IN EFI_HANDLE

Handle,

...
);

Parameters

Handle

The handle to remove the protocol interfaces from.

...

A variable argument list containing pairs of protocol GUIDs and
protocol interfaces.

Description

This function removes a set of protocol interfaces from the boot services environment. It removes
arguments from the variable argument list in pairs. The first item is always a pointer to the
protocol’s GUID, and the second item is always a pointer to the protocol’s interface. These pairs
are used to call the boot service

UninstallProtocolInterface()

to remove a protocol

interface from

Handle

. The pairs of arguments are removed in order from the variable argument

list until a

NULL

protocol GUID value is found. If all of the protocols are uninstalled from

Handle

, then

EFI_SUCCESS

is returned. If any errors are generated while the protocol

interfaces are being uninstalled, then the protocols uninstalled prior to the error will be reinstalled
with the boot service

InstallProtocolInterface()

and the status code

EFI_INVALID_PARAMETER

is returned.

Status Codes Returned

EFI_SUCCESS

All the protocol interfaces were removed.

EFI_INVALID_PARAMETER

One of the protocol interfaces was not previously installed on

Handle

.