cpanel.h File Reference

#include <cpl.h>

Include dependency graph for cpanel.h:

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

Go to the source code of this file.

Classes
struct	applet_info
struct	CPlApplet
struct	CPanel
struct	CPlItem

Typedefs
typedef struct CPlApplet	CPlApplet
typedef struct CPanel	CPanel
typedef struct CPlItem	CPlItem

Functions
CPlApplet *	Control_LoadApplet (HWND hWnd, LPCWSTR cmd, CPanel *panel) DECLSPEC_HIDDEN
void	Control_UnloadApplet (CPlApplet *applet) DECLSPEC_HIDDEN

Typedef Documentation

CPanel

typedef struct CPanel CPanel

CPlApplet

typedef struct CPlApplet CPlApplet

CPlItem

typedef struct CPlItem CPlItem

Function Documentation

Control_LoadApplet()

CPlApplet* Control_LoadApplet	(	HWND	hWnd,
		LPCWSTR	cmd,
		CPanel *	panel
	)

Definition at line 59 of file control.c.

{
#ifdef __REACTOS__
    ACTCTXW ActCtx = {sizeof(ACTCTX), ACTCTX_FLAG_RESOURCE_NAME_VALID};
    ULONG_PTR cookie;
    BOOL bActivated;
    WCHAR fileBuffer[MAX_PATH];
#endif
    CPlApplet*  applet;
    DWORD len;
    unsigned    i;
    CPLINFO info;
    NEWCPLINFOW newinfo;

    if (!(applet = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(*applet))))
       return applet;

    len = ExpandEnvironmentStringsW(cmd, NULL, 0);
    if (len > 0)
    {
        if (!(applet->cmd = HeapAlloc(GetProcessHeap(), 0, (len+1) * sizeof(WCHAR))))
        {
            WARN("Cannot allocate memory for applet path\n");
            goto theError;
        }
        ExpandEnvironmentStringsW(cmd, applet->cmd, len+1);
    }
    else
    {
        WARN("Cannot expand applet path\n");
        goto theError;
    }

    applet->hWnd = hWnd;

#ifdef __REACTOS__
    StringCchCopy(fileBuffer, MAX_PATH, applet->cmd);
    if (PathIsFileSpecW(fileBuffer))
        SearchPath(NULL, fileBuffer, NULL, MAX_PATH, fileBuffer, NULL);
    ActCtx.lpSource = fileBuffer;
    ActCtx.lpResourceName = (LPCWSTR)123;
    applet->hActCtx = CreateActCtx(&ActCtx);
    bActivated = (applet->hActCtx != INVALID_HANDLE_VALUE ? ActivateActCtx(applet->hActCtx, &cookie) : FALSE);
#endif

    if (!(applet->hModule = LoadLibraryW(applet->cmd))) {
        WARN("Cannot load control panel applet %s\n", debugstr_w(applet->cmd));
    goto theError;
    }
    if (!(applet->proc = (APPLET_PROC)GetProcAddress(applet->hModule, "CPlApplet"))) {
        WARN("Not a valid control panel applet %s\n", debugstr_w(applet->cmd));
    goto theError;
    }
    if (!applet->proc(hWnd, CPL_INIT, 0L, 0L)) {
        WARN("Init of applet has failed\n");
    goto theError;
    }
    if ((applet->count = applet->proc(hWnd, CPL_GETCOUNT, 0L, 0L)) == 0) {
        WARN("No subprogram in applet\n");
        applet->proc(applet->hWnd, CPL_EXIT, 0, 0);
    goto theError;
    }

    applet = HeapReAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, applet,
                         FIELD_OFFSET( CPlApplet, info[applet->count] ));

    for (i = 0; i < applet->count; i++) {
       ZeroMemory(&newinfo, sizeof(newinfo));
       newinfo.dwSize = sizeof(NEWCPLINFOA);
       applet->info[i].helpfile[0] = 0;
       /* proc is supposed to return a null value upon success for
    * CPL_INQUIRE and CPL_NEWINQUIRE
    * However, real drivers don't seem to behave like this
    * So, use introspection rather than return value
    */
       applet->proc(hWnd, CPL_INQUIRE, i, (LPARAM)&info);
       applet->info[i].data = info.lData;
#ifdef __REACTOS__
       applet->info[i].idIcon = info.idIcon;
#endif

       if (info.idIcon != CPL_DYNAMIC_RES)
       applet->info[i].icon = LoadIconW(applet->hModule, MAKEINTRESOURCEW(info.idIcon));
       if (info.idName != CPL_DYNAMIC_RES)
       LoadStringW(applet->hModule, info.idName,
               applet->info[i].name, sizeof(applet->info[i].name) / sizeof(WCHAR));
       if (info.idInfo != CPL_DYNAMIC_RES)
       LoadStringW(applet->hModule, info.idInfo,
               applet->info[i].info, sizeof(applet->info[i].info) / sizeof(WCHAR));

       /* some broken control panels seem to return incorrect values in CPL_INQUIRE,
          but proper data in CPL_NEWINQUIRE. if we get an empty string or a null
          icon, see what we can get from CPL_NEWINQUIRE */

       if (!applet->info[i].name[0]) info.idName = CPL_DYNAMIC_RES;

       /* zero-length szInfo may not be a buggy applet, but it doesn't hurt for us
          to check anyway */

       if (!applet->info[i].info[0]) info.idInfo = CPL_DYNAMIC_RES;

       if (applet->info[i].icon == NULL)
           info.idIcon = CPL_DYNAMIC_RES;

       if ((info.idIcon == CPL_DYNAMIC_RES) || (info.idName == CPL_DYNAMIC_RES) ||
           (info.idInfo == CPL_DYNAMIC_RES)) {
       applet->proc(hWnd, CPL_NEWINQUIRE, i, (LPARAM)&newinfo);

       applet->info[i].data = newinfo.lData;
       if (info.idIcon == CPL_DYNAMIC_RES) {
           if (!newinfo.hIcon) WARN("couldn't get icon for applet %u\n", i);
           applet->info[i].icon = newinfo.hIcon;
       }
       if (newinfo.dwSize == sizeof(NEWCPLINFOW)) {
           if (info.idName == CPL_DYNAMIC_RES)
               memcpy(applet->info[i].name, newinfo.szName, sizeof(newinfo.szName));
           if (info.idInfo == CPL_DYNAMIC_RES)
               memcpy(applet->info[i].info, newinfo.szInfo, sizeof(newinfo.szInfo));
           memcpy(applet->info[i].helpfile, newinfo.szHelpFile, sizeof(newinfo.szHelpFile));
       } else {
           if (info.idName == CPL_DYNAMIC_RES)
                   MultiByteToWideChar(CP_ACP, 0, ((LPNEWCPLINFOA)&newinfo)->szName,
                                   sizeof(((LPNEWCPLINFOA)&newinfo)->szName) / sizeof(CHAR),
                           applet->info[i].name, sizeof(applet->info[i].name) / sizeof(WCHAR));
           if (info.idInfo == CPL_DYNAMIC_RES)
                   MultiByteToWideChar(CP_ACP, 0, ((LPNEWCPLINFOA)&newinfo)->szInfo,
                                   sizeof(((LPNEWCPLINFOA)&newinfo)->szInfo) / sizeof(CHAR),
                           applet->info[i].info, sizeof(applet->info[i].info) / sizeof(WCHAR));
               MultiByteToWideChar(CP_ACP, 0, ((LPNEWCPLINFOA)&newinfo)->szHelpFile,
                               sizeof(((LPNEWCPLINFOA)&newinfo)->szHelpFile) / sizeof(CHAR),
                       applet->info[i].helpfile,
                                   sizeof(applet->info[i].helpfile) / sizeof(WCHAR));
           }
       }
    }

#ifdef __REACTOS__
    if (bActivated)
        DeactivateActCtx(0, cookie);
#endif

#ifndef __REACTOS__
    list_add_head( &panel->applets, &applet->entry );
#endif

    return applet;

 theError:
    FreeLibrary(applet->hModule);
    HeapFree(GetProcessHeap(), 0, applet->cmd);
    HeapFree(GetProcessHeap(), 0, applet);
    return NULL;
}

Referenced by Control_DoLaunch(), Control_DoWindow(), Control_RegisterRegistryApplets(), and CControlPanelEnum::RegisterCPanelApp().

Control_UnloadApplet()

void Control_UnloadApplet

(

CPlApplet *

applet

)

Definition at line 43 of file control.c.

{
    unsigned    i;

    for (i = 0; i < applet->count; i++)
        applet->proc(applet->hWnd, CPL_STOP, i, applet->info[i].data);

    if (applet->proc) applet->proc(applet->hWnd, CPL_EXIT, 0L, 0L);
    FreeLibrary(applet->hModule);
#ifndef __REACTOS__
    list_remove( &applet->entry );
#endif
    HeapFree(GetProcessHeap(), 0, applet->cmd);
    HeapFree(GetProcessHeap(), 0, applet);
}

Referenced by Control_DoLaunch(), Control_WndProc(), and CControlPanelEnum::RegisterCPanelApp().