VXPLib Documentation: COM

IVXPQuickHTML::SetDefaultRes

Sets the default resource file to be used by the parser when there is no alternative resource file specified. See Remarks.


HRESULT SetDefaultRes(BSTR FilePath, VARIANT_BOOL * succeeded);


Parameters

FilePath [in] - Full path to any file (EXE, DLL, OCX, CPL, ...etc) that contains resources
succeeded [out, retval] - Pointer to a boolean variable that recieves True, if succeeded to load the resource library, or False otherwise.
Remarks

SetDefaultRes loads the file using API function LoadLibraryEx(...) specifying flag LOAD_LIBRARY_AS_DATAFILE for speed optimization.
Whenever the parser meets a reference to a resource, and there is no explicit resource specifier it uses the default resource file. Unlike with specified resources the parser can access resources from the default resource file significantly faster, because it loads such file only once when SetDefaultRes is called.
When a new instance of IVXPQuickHTML is created the object calls SetDefaultRes with full path to the client's process executable file.
The loaded library will be unloaded automatically when the parser instance is destroyed. Repeated invocation of SetDefaultRes unloads the previously loaded library automatically.
See Also

IVXPQuickHTML Overview


This document was last updated on 03/02/2003