Public Member Functions
|Default construtor. |
|const ACE_TCHAR *||dll_name () const|
|Returns the name of the shared library (without prefixes or suffixes). |
|int||open (const ACE_TCHAR *dll_name, int open_mode, ACE_SHLIB_HANDLE handle)|
|int||close (int unload=0)|
|sig_atomic_t||refcount (void) const|
|Return the current refcount. |
|void *||symbol (const ACE_TCHAR *symbol_name, int ignore_errors=0)|
|ACE_SHLIB_HANDLE||get_handle (int become_owner=0)|
Private Member Functions
|auto_ptr< ACE_TString >||error (void)|
|void||get_dll_names (const ACE_TCHAR *dll_name, ACE_Array< ACE_TString > &try_names)|
|ACE_DLL_Handle (const ACE_DLL_Handle &)|
|void||operator= (const ACE_DLL_Handle &)|
|Name of the shared library. |
|Handle to the actual library loaded by the OS. |
Static Private Attributes
|static sig_atomic_t||open_called_ = 0|
This class is an wrapper over the various methods for utilizing a dynamically linked library (DLL), which is called a shared library on some platforms. It is refcounted and managed by ACE_DLL_Manager, so there will only be a single instance of this class for each dll loaded, no matter how many instances of ACE_DLL an application has open. Operations <open>, <close>, and <symbol> have been implemented to help opening/closing and extracting symbol information from a DLL, respectively.
|ACE_DLL_Handle::ACE_DLL_Handle||(||const ACE_DLL_Handle &||)||
|const ACE_TCHAR * ACE_DLL_Handle::dll_name||(||void||)||const|
Returns the name of the shared library (without prefixes or suffixes).
This method opens and dynamically links dll_name. The default mode is <RTLD_LAZY>, which loads identifier symbols but not the symbols for functions, which are loaded dynamically on-demand. Other supported modes include: <RTLD_NOW>, which performs all necessary relocations when dll_name is first loaded and <RTLD_GLOBAL>, which makes symbols available for relocation processing of any other DLLs. Returns -1 on failure and 0 on success.
|int ACE_DLL_Handle::close||(||int|| unload =
Call to close the DLL object. If unload = 0, it only decrements the refcount, but if unload = 1, then it will actually unload the library when the refcount == 0;
Return the current refcount.
|void * ACE_DLL_Handle::symbol||(||const ACE_TCHAR *||symbol_name,|
|int|| ignore_errors = |
If symbol_name is in the symbol table of the DLL a pointer to the symbol_name is returned. Otherwise, returns 0. Set the ignore_errors flag to supress logging errors if symbol_name isn't found. This is nice if you just want to probe a dll to see what's available, since missing functions in that case aren't really errors.
|ACE_SHLIB_HANDLE ACE_DLL_Handle::get_handle||(||int|| become_owner =
Return the handle to the caller. If become_owner is non-0 then caller assumes ownership of the handle so we decrement the retcount.
Returns a pointer to a string explaining why <symbol> or <open> failed. This is used internal to print out the error to the log, but since this object is shared, we can't store or return the error to the caller.
|void ACE_DLL_Handle::get_dll_names||(||const ACE_TCHAR *||dll_name,|
|ACE_Array< ACE_TString > &||try_names|
|void ACE_DLL_Handle::operator=||(||const ACE_DLL_Handle &||)||