cpLINFO 結構 (cpl.h)

包含主控台應用程式所支援之對話方塊的資源資訊和應用程式定義值。 主控台應用程式的CPlApplet函式會將此資訊傳回給主控台，以回應CPL_INQUIRE訊息。

語法

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

成員

idIcon

類型： int

代表對話方塊之圖示的資源識別碼。

idName

類型： int

字串的資源識別碼，其中包含對話方塊的簡短名稱。 此名稱旨在顯示在圖示下方。

idInfo

類型： int

字串的資源識別碼，其中包含選取應用程式圖示時所要顯示的對話方塊描述。

lData

類型： LONG_PTR

應用程式所定義之資料的指標。 當主控台傳送CPL_DBLCLK和CPL_STOP訊息時，會將此值傳回您的應用程式。

備註

如果對話方塊的圖示或顯示字串可以根據電腦的狀態變更，您可以指定 idIcon、 idName或 idInfo 成員的CPL_DYNAMIC_RES值，而不是指定有效的資源識別碼。 這會導致每次需要圖示和顯示字串時，主控台傳送CPL_NEWINQUIRE訊息。 不過，使用這項技術會大幅變慢，因為每次傳送CPL_NEWINQUIRE訊息時，主控台都必須載入您的應用程式。

規格需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	cpl.h