CPL_NEWINQUIRE訊息

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

參數

uAppNum

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

lpncpli

NEWCPLINFO結構的位址。 主控台應用程式應該以對話方塊的相關資訊填入此結構。

傳回值

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

備註

為了提升效能，大部分的應用程式都應該忽略 CPL_NEWINQUIRE 並改為處理 CPL_INQUIRE 訊息。

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

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

CPL_INQUIRE 是慣用的訊息。 這是因為 CPL_NEWINQUIRE 會以系統無法快取的形式傳回信息。 因此，每次主控台需要資訊時，都必須載入處理CPL_NEWINQUIRE的應用程式，因而大幅降低效能。

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

規格需求

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