response.registerCFunction() (Method)

Register a native C language function for use with callC().

Availability:

JavaScript - 1.1
Netscape Enterprise Server - 2.0
Property/method value type:Boolean primitive
JavaScript syntax:NESregisterCFunction(aFunctionName, aLibrary, aCFunction)
Argument list:aCFunctionThe name of the C function in the library
aFunctionNameThe name of the function in the JavaScript environment
aLibraryA path to the library containing the C function

External library functions can be registered with the Netscape Enterprise Server and can then be called from scripts running in the request-response loop.

Such registered functions are invoked with the callC() method.

The registration process creates a mapping between the JavaScript environment and the C language environment. This suggests that the two need not be named the same although it is good practice to preserve the names recognizably across such wrapping mechanisms.

The C function is encapsulated in a JavaScript object wrapper.

A Boolean true value is returned if the registration succeeds and a Boolean false if it fails.

See also:Netscape Enterprise Server