dynamiclibrary_windows.h File Reference

#include <Windows.h>
#include "BOOL.h"

Include dependency graph for dynamiclibrary_windows.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines
#define	IMPORT_EXPORT_DYNAMICLIBRARY_DLL   __declspec(dllimport)
Typedefs
typedef HINSTANCE	DynLibHandle
typedef FARPROC	DynLibFuncPtr
Functions
IMPORT_EXPORT_DYNAMICLIBRARY_DLL DynLibHandle	LoadDynLibrary (char *libname)
IMPORT_EXPORT_DYNAMICLIBRARY_DLL BOOL	FreeDynLibrary (DynLibHandle hInstance)
IMPORT_EXPORT_DYNAMICLIBRARY_DLL DynLibFuncPtr	GetDynLibFuncPtr (DynLibHandle hInstance, char *funcName)
IMPORT_EXPORT_DYNAMICLIBRARY_DLL char *	GetLastDynLibError (void)

---

Define Documentation

#define IMPORT_EXPORT_DYNAMICLIBRARY_DLL   __declspec(dllimport)

Definition at line 22 of file dynamiclibrary_windows.h.

---

Typedef Documentation

typedef FARPROC DynLibFuncPtr

Definition at line 26 of file dynamiclibrary_windows.h.

typedef HINSTANCE DynLibHandle

Definition at line 25 of file dynamiclibrary_windows.h.

---

Function Documentation

IMPORT_EXPORT_DYNAMICLIBRARY_DLL BOOL FreeDynLibrary

(

DynLibHandle

hInstance

)

Decrements the reference count of the loaded dynamic-link library

Parameters:

Handle

to the loaded library

Returns:

BOOL If the function succeeds, the return value is nonzero

Definition at line 21 of file dynamiclibrary_others.c.

References FALSE, NULL, and TRUE.

{
        if (hInstance)
                {
                        if (dlclose( hInstance)) return TRUE;
                }
        #ifndef NDEBUG
        else 
                {
                        printf("FreeDynLibrary: Cannot close a not-opened library.\n");
                        fflush(NULL);
                }
        #endif

        return FALSE;
}

IMPORT_EXPORT_DYNAMICLIBRARY_DLL DynLibFuncPtr GetDynLibFuncPtr	(	DynLibHandle	hInstance,
		char *	funcName
	)

Retrieves the address of an exported function

Parameters:

	Handle	to the loaded library
	string	that specifies the function

Returns:

Retrieves the address of an exported function

Parameters:

	Handle	to the loaded library
	string	that specifies the function

Returns:

a pointer

Definition at line 38 of file dynamiclibrary_others.c.

References NULL.

{
        if (hInstance)
        {
                return dlsym(hInstance, funcName);
        }
        return NULL;
}

IMPORT_EXPORT_DYNAMICLIBRARY_DLL char* GetLastDynLibError

(

void

)

return last dynamic linking error

Returns:

a string

Definition at line 37 of file dynamiclibrary_windows.c.

References buffer, and NULL.

{
        static char buffer[512];
        DWORD dw = GetLastError(); 
        DWORD source = 0;

        if (FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM |
                        FORMAT_MESSAGE_IGNORE_INSERTS, &source, dw, 0,
                        buffer, 512, NULL) == 0) 
        {
                        strcpy(buffer, "Unknown Error");
        }

        return buffer;
}

IMPORT_EXPORT_DYNAMICLIBRARY_DLL DynLibHandle LoadDynLibrary

(

char *

libname

)

Maps the specified executable module into the address space of the calling process

Parameters:

name

of dynamic library

Returns:

Handle to the loaded library

Definition at line 15 of file dynamiclibrary_windows.c.

{
        return (DynLibHandle) LoadLibrary(libname);
}