Funzione InitializePrintMonitor (winsplp.h)
La funzione InitializePrintMonitor è obsoleta ed è supportata solo per scopi di compatibilità. I nuovi monitoraggi di stampa devono implementare InitializePrintMonitor2 in modo che possano essere usati con cluster server di stampa.
La funzione InitializePrintMonitor di un monitor di stampa 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.
Commenti
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 monitoraggio di inizializzare se stesso e di fornire al puntatore le funzioni di monitoraggio interno. I puntatori di funzione sono contenuti in una struttura MONITOR , a cui viene fatto riferimento tramite la funzione MONITOREX .
Il parametro pRegistryRoot fornisce un puntatore una stringa che rappresenta il percorso di una chiave del Registro di sistema MonitorName , dove MonitorName è il nome del monitoraggio specificato quando la funzione AddMonitor del spooler è stata chiamata per aggiungere il monitoraggio. Il monitoraggio può usare questa chiave per archiviare nomi e valori di valore specifici del monitoraggio. Quando viene chiamata la funzione DeleteMonitor del spooler, il spooler elimina la chiave MonitorName e tutti i valori archiviati sotto di esso. Le funzioni AddMonitor e DeleteMonitor sono descritte nella documentazione di Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winsplp.h (include Winsplp.h) |