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
|