Partager via


Fonction InitializePrintMonitor (winsplp.h)

La fonction InitializePrintMonitor est obsolète et est prise en charge uniquement à des fins de compatibilité. Les nouveaux moniteurs d’impression doivent implémenter InitializePrintMonitor2 afin qu’ils puissent être utilisés avec des clusters de serveur d’impression.

La fonction InitializePrintMonitor d’un moniteur d’impression initialise un moniteur d’impression.

Syntaxe

LPMONITOREX InitializePrintMonitor(
  [in] LPWSTR pRegistryRoot
);

Paramètres

[in] pRegistryRoot

Pointeur fourni par l’appelant vers une chaîne identifiant un chemin d’accès de Registre que le moniteur d’impression peut utiliser pour stocker des valeurs spécifiques au moniteur.

Valeur retournée

Si l’opération réussit, la fonction doit retourner un pointeur vers une structure MONITOREX . Sinon, la fonction doit appeler SetLastError (décrit dans la documentation Microsoft Windows SDK) pour définir un code d’erreur et retourner null.

Remarques

La fonction InitializePrintMonitor doit être exportée par moniteurs de langue et par DLL de serveur de surveillance de port. La fonction est appelée immédiatement après le chargement de la DLL du moniteur et n’est pas appelée à nouveau tant que la DLL n’est pas rechargée. Ses objectifs sont de permettre au moniteur de s’initialiser et de fournir au spouleur des pointeurs vers les fonctions de supervision internes. Les pointeurs de fonction sont contenus dans une structure MONITOR , qui est référencée via la fonction MONITOREX .

Le paramètre pRegistryRoot fournit à un pointeur une chaîne représentant le chemin d’accès à une clé de Registre MonitorName , où MonitorName est le nom du moniteur qui a été spécifié lorsque la fonction AddMonitor du spouleur a été appelée pour ajouter le moniteur. Le moniteur peut utiliser cette clé pour stocker des noms de valeurs et des valeurs spécifiques à l’analyse. Lorsque la fonction DeleteMonitor du spouleur est appelée, le spouleur supprime la clé MonitorName et toutes les valeurs stockées sous celle-ci. (Les fonctions AddMonitor et DeleteMonitor sont décrites dans la documentation SDK Windows.)

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête winsplp.h (inclure Winsplp.h)

Voir aussi

InitializePrintMonitorUI

MONITOREX