[Home] [ToC] [Up] [Prev] [Next]

iHTML Browser Services

Shared Libraries

The browser's shared library services include an opaque type and three functions that are used to dynamically load and interrogate external code segments. These services are typically implemented in the operating system glue of the browser.

Types

IHSharedModule

Synopsis

A handle on a dynamically-loaded code module.

Definition

void* (This is an opaque type that is defined by the browser's internal implementation.)

See Also

BR_LoadSharedModule()

This type represents a handle on an external piece of code that has been dynamically loaded by the browser. Once loaded, the module can be queried for symbols and unloaded.

Functions

BR_GetSharedSymbol

Synopsis

int BR_GetSharedSymbol(IHSharedModule module, const char* symbol, void* storage)

Arguments

(IHSharedModule) module

Handle on the shared code module that is to be queried.

(const char*) symbol

The module's symbol, as seen by its programmer, to retrieve.

(void*) storage

Place to save the symbol's value.

Return

(int) TRUE if the symbol was successfully retrieved, else FALSE.

See Also

IHSharedModule, BR_LoadSharedModule()

Retrieves the given symbol name from the previously loaded shared module, and stores its value in the address pointed to by storage.

BR_LoadSharedModule

Synopsis

IHSharedModule BR_LoadSharedModule(const char* dir, const char* name)

Arguments

(const char*) dir

The directory to look for the module in.

(const char*) name

The name of the module's file, without any operating system specific extension or prefix.

Return

(IHSharedModule) A handle on the loaded module, or NULL if it could not be found.

See Also

IHSharedModule

Looks for the given external shared module; if it exists, it is loaded into the browser and an abstract handle for it is returned. If it doesn't exist or can't be loaded, a NULL handle is returned.

BR_UnloadSharedModule

Synopsis

void BR_UnloadSharedModule(IHSharedModule module)

Arguments

(IHSharedModule) module

A previously loaded code module.

Return

nothing.

See Also

IHSharedModule, BR_LoadSharedModule()

Unloads an external shared module that was previously loaded with BR_LoadSharedModule().

[Home] [ToC] [Up] [Prev] [Next]

Dianne Kyra Hackborn <hackbod@angryredplanet.com>

Last modified: Sat Oct 26 23:32:20 PDT 1996

This web page and all material contained herein is Copyright (c) 1997 Dianne Hackborn, unless otherwise noted. All rights reserved.