NEWCPLINFOW 是 Win32 API 中定义的一个结构体,位于 <Cpl.h> 头文件中。该结构体用于传递控制面板应用程序(CPL)的信息。以下是该结构体的定义:
typedef struct tagNEWCPLINFOW {
    DWORD dwSize;         // 结构体的大小,用于版本控制
    DWORD dwFlags;        // 控制面板信息标志
    DWORD dwHelpContext;  // 帮助上下文标识符
    LONG lData;           // 与 CPL 进程相关的数据
    HICON hIcon;          // 控制面板图标的句柄
    WCHAR szName[32];     // 控制面板的名称
    WCHAR szInfo[64];     // 控制面板的描述信息
    WCHAR szHelpFile[128];// 控制面板帮助文件的路径
} NEWCPLINFOW, *LPNEWCPLINFOW;

各个字段的含义如下:

  •  dwSize: 结构体的大小,用于版本控制,应该设置为 sizeof(NEWCPLINFOW)。

  •  dwFlags: 控制面板信息标志,指定控制面板应用程序的行为。例如,CPL_DYNAMIC_RES 表示应用程序支持动态更改分辨率。

  •  dwHelpContext: 帮助上下文标识符,用于关联帮助文件中的特定主题。

  •  lData: 与 CPL 进程相关的数据,可以用于传递额外的信息给 CPL。

  •  hIcon: 控制面板图标的句柄,用于显示在控制面板中。

  •  szName: 控制面板的名称,以 null 终止的字符串,最大长度为 32 个字符。

  •  szInfo: 控制面板的描述信息,以 null 终止的字符串,最大长度为 64 个字符。

  •  szHelpFile: 控制面板帮助文件的路径,以 null 终止的字符串,最大长度为 128 个字符。


这个结构体主要用于在调用 CPL_NEWINQUIRE 消息时传递信息给 CPL 应用程序。在实际使用中,你可以设置相应的字段,然后将结构体传递给 CPL 应用程序。


转载请注明出处:http://www.zyzy.cn/article/detail/25112/Win32 API/Cpl.h/NEWCPLINFOW