Verwerking van berichten in configuratiescherm
De CPlApplet callback-functie verwerkt alle berichten die door Windows naar een Configuratiescherm-item worden verzonden. Berichten die naar de functie worden verzonden, bevinden zich in een specifieke volgorde. Met hetzelfde token vereist het .cpl item dat de berichten op een specifieke manier worden verwerkt.
Eerst ontvangt de CPlApplet-functie het CPL_INIT bericht wanneer Windows het configuratiescherm-item voor het eerst laadt. De functie moet elke initialisatie uitvoeren, zoals het toewijzen van geheugen en het retourneren van niet-nul. Als CPlApplet- de initialisatie niet kan voltooien, moet deze nul retourneren, waardoor Windows de communicatie beëindigt en het DLL-bestand vrijgeeft.
Als het CPL_INIT bericht is voltooid, wordt vervolgens het CPL_GETCOUNT bericht verzonden. De functie moet vervolgens het aantal Configuratiescherm-items retourneren die worden ondersteund door het .dll-bestand.
De functie CPlApplet ontvangt vervolgens één CPL_INQUIRE bericht en één CPL_NEWINQUIRE bericht voor elk configuratiescherm-item dat wordt ondersteund door het .dll bestand. De functie vult een CPLINFO- of NEWCPLINFO structuur in met informatie over uw item, zoals de naam, het pictogram en een beschrijvende tekenreeks. De meeste toepassingen moeten het CPL_INQUIRE bericht verwerken en het CPL_NEWINQUIRE bericht negeren. Het CPL_INQUIRE bericht bevat informatie in een formulier dat Windows kan opslaan, wat resulteert in veel betere prestaties. Het CPL_NEWINQUIRE bericht wordt alleen gebruikt als u het pictogram van het item moet wijzigen of tekenreeksen wilt weergeven op basis van de status van de computer. Items in het Configuratiescherm die CPL_NEWINQUIRE gebruiken, kunnen niet worden gevonden door een zoeken in het menu Start in Windows Vista, omdat deze afhankelijk is van caching.
De CPlApplet-functie ontvangt vervolgens een CPL_DBLCLK bericht als een melding dat de gebruiker het pictogram heeft gekozen dat het configuratiescherm-item vertegenwoordigt. De functie kan dit bericht een willekeurig aantal keren ontvangen. Het bericht bevat de itemidentifier en de lpData aanwijzer die wordt geretourneerd in de CPLINFO- of NEWCPLINFO- structuur in de aanroep van CPL_INQUIRE of CPL_NEWINQUIRE. De functie moet het bijbehorende dialoogvenster weergeven en volgende gebruikersinvoer verwerken.
Naast CPL_DBLCLK kan het CPL_STARTWPARMS bericht worden verzonden als een Item in het Configuratiescherm wordt aangeroepen met invoerparameters, zoals vanaf een opdrachtprompt of vanuit een ander programma. Het bericht bevat de item-id samen met de extra parametertekenreeks.
Voordat de besturingstoepassing wordt beëindigd, ontvangt CPlApplet- het CPL_STOP bericht eenmaal voor elk configuratiescherm-item dat wordt ondersteund door het .dll bestand. Het bericht bevat de identificatie voor een item van het Configuratiescherm en de lpData- aanwijzer die wordt geretourneerd in de CPLINFO- of NEWCPLINFO- structuur bij het aanroepen van CPL_INQUIRE of CPL_NEWINQUIRE. De functie moet geheugen vrij maken die voor het opgegeven dialoogvenster is toegewezen.
Na het laatste CPL_STOP bericht ontvangt CPlApplet- een CPL_EXIT bericht. De functie moet alle resterende toegewezen geheugen vrij maken en de registratie van eventuele privévensterklassen ongedaan maken die mogelijk zijn geregistreerd. Zodra de functie terugkeert van dit bericht, bevrijdt Windows het Configuratiescherm-item door de functie FreeLibrary aan te roepen.
Verwante onderwerpen
-
CPLApplet- gebruiken
-
het maken van doorzoekbare taakkoppelingen voor een Configuratiescherm-item
-
toegang tot het Configuratiescherm in de veilige modus onder Windows Vista