Funzione InitializePrintMonitor (winsplp.h)
La funzione InitializePrintMonitor è obsoleta ed è supportata solo a scopo di compatibilità. I nuovi monitoraggi di stampa devono implementare InitializePrintMonitor2 in modo che possano essere usati con i cluster server di stampa.
Un monitor di stampa InitializePrintMonitor funzione inizializza un monitor di stampa.
Sintassi
LPMONITOREX InitializePrintMonitor(
[in] LPWSTR pRegistryRoot
);
Parametri
[in] pRegistryRoot
Puntatore fornito dal chiamante a una stringa che identifica un percorso del Registro di sistema che il monitor di stampa può usare per archiviare valori specifici del monitoraggio.
Valore restituito
Se l'operazione ha esito positivo, la funzione deve restituire un puntatore a una struttura MONITOREX. In caso contrario, la funzione deve chiamare SetLastError (descritta nella documentazione di Microsoft Windows SDK) per impostare un codice di errore e restituire NULL.
Osservazioni
La funzione InitializePrintMonitor deve essere esportata dai monitoraggi del linguaggio e dalle DLL del server di monitoraggio delle porte. La funzione viene chiamata immediatamente dopo il caricamento della DLL di monitoraggio e non viene chiamata di nuovo finché la DLL non viene ricaricata. I suoi scopi sono consentire al monitor di inizializzare se stesso e di fornire allo spooler i puntatori alle funzioni di monitoraggio interno. I puntatori a funzione sono contenuti in una struttura di MONITOR, a cui viene fatto riferimento tramite la funzione MONITOREX.
Il parametro pRegistryRoot fornisce un puntatore a una stringa che rappresenta il percorso di una chiave del Registro di sistema MonitorName, dove MonitorName è il nome del monitoraggio specificato quando è stata chiamata la funzione AddMonitor del spooler per aggiungere il monitoraggio. Il monitoraggio può usare questa chiave per archiviare valori e nomi di valori specifici del monitoraggio. Quando viene chiamata la funzione di DeleteMonitor dello spooler, lo spooler elimina la chiave MonitorName e tutti i valori archiviati sotto di esso. Le funzioni di AddMonitor e DeleteMonitor sono descritte nella documentazione di Windows SDK.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | winsplp.h (includere Winsplp.h) |