CPL_INQUIRE訊息

傳送至主控台應用程式的CPlApplet函式，以要求應用程式支援的對話方塊相關資訊。

參數

uAppNum

對話方塊編號。 這個數位的範圍必須是零到一個小於傳回的值，以回應 CPL_GETCOUNT 訊息 (CPL_GETCOUNT – 1) 。

lpcpli

CPLINFO結構的位址。 應用程式必須以圖示的資源識別碼、簡短名稱、描述，以及與對話方塊相關聯的任何使用者定義值填滿此結構。

傳回值

如果 CPlApplet 函式已成功處理此訊息，它應該會傳回零。

備註

主控台會針對應用程式支援的每個對話方塊傳送一次CPL_INQUIRE訊息。 主控台也會針對每個對話方塊傳送CPL_NEWINQUIRE訊息。 這些訊息會在 CPL_GETCOUNT 訊息之後立即傳送。 不過，系統不保證傳送 CPL_INQUIRE 和 CPL_NEWINQUIRE 訊息的順序。

當您收到 CPL_INQUIRE時，您可以執行對話方塊的初始化。 如果您必須配置記憶體，請執行此動作以回應 CPL_INIT 訊息。

CPL_NEWINQUIRE訊息會以系統無法快取的格式傳回信息。 基於這個理由，大部分 的 CPlApplet 函式都應該處理 CPL_INQUIRE 並忽略 CPL_NEWINQUIRE。

唯一應該使用 CPL_NEWINQUIRE 的應用程式是需要根據電腦狀態變更其圖示或顯示字串的應用程式。 在此情況下，您的CPL_INQUIRE處理常式應該為CPLINFO結構的idIcon、idName或idInfo成員指定CPL_DYNAMIC_RES值，而不是指定有效的資源識別碼。 這會導致每次需要圖示並顯示字串時，主控台傳送CPL_NEWINQUIRE訊息，讓您根據電腦的目前狀態來指定資訊。 這比使用快取的資訊慢很多。

規格需求

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