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)

Vedi anche

InitializePrintMonitorUI

MONITOREX