NAME

ISL_LocateProcedureAddress

SYNOPSIS

void * ISL_LocateProcedureAddress
    (ISL_VERIFIED_MODULE_PTR Module,
    ISL_CONST_DATA Name)

DESCRIPTION

This function returns the address of a function in a verified object code module. The function of interest is specified by Name. The address returned is read from the symbol table associated with the module.

To complete a secure linkage check before invoking the loaded module, the returned address must be checked to determine whether it is actually within the bounds of the verified object code module. If the symbol table associated with the object code module has been modified, the address can reference code outside of the verified module. The function ISL_CheckAddressWithinModule can to check the address for containment in the verified module.

PARAMETERS

Module (input)

A handle to a verified object module returned by ISL_VerifyLoadedModuleAndCredentials, ISL_VerifyAndLoadModuleAndCredentials, ISL_SelfCheck, ISL_VerifyAndLoadModule, or ISL_VerifyLoadedModule.

Name (input)

An entry point name as required by the platform.

RETURN VALUE

Pointer to the procedure entry point, or NULL if unsuccessful.

SEE ALSO

ISL_CheckAddressWithinModule,
ISL_VerifyLoadedModuleAndCredentials,
ISL_VerifyAndLoadModuleAndCredentials,
ISL_SelfCheck,
ISL_VerifyAndLoadModule,
ISL_VerifyLoadedModule