Structure MONITORREG (winsplp.h)

La structure MONITORREG fournit des moniteurs d’impression avec l’adresse des fonctions de Registre à utiliser à la place des fonctions API de Registre Win32.

Syntaxe

typedef struct _MONITORREG {
  DWORD cbSize;
  LONG()(HKEYMONITOR hcKey,LPCTSTR pszSubKey,DWORD dwOptions,REGSAM samDesired,PSECURITY_ATTRIBUTES pSecurityAttributes,HKEYMONITOR *phckResult,PDWORD pdwDisposition,HANDLE hSpooler) * fpCreateKey;
  LONG()(HKEYMONITOR hcKey,LPCTSTR pszSubKey,REGSAM samDesired,HKEYMONITOR *phkResult,HANDLE hSpooler) * fpOpenKey;
  LONG( )(HKEYMONITOR hcKey,HANDLE hSpooler) *fpCloseKey;
  LONG( )(HKEYMONITOR hcKey,LPCTSTR pszSubKey,HANDLE hSpooler) *fpDeleteKey;
  LONG( )(HKEYMONITOR hcKey,DWORD dwIndex,LPTSTR pszName,PDWORD pcchName,PFILETIME pftLastWriteTime,HANDLE hSpooler) *fpEnumKey;
  LONG( )(HKEYMONITOR hcKey,PDWORD pcSubKeys,PDWORD pcbKey,PDWORD pcValues,PDWORD pcbValue,PDWORD pcbData,PDWORD pcbSecurityDescriptor,PFILETIME pftLastWriteTime,HANDLE hSpooler) *fpQueryInfoKey;
  LONG()(HKEYMONITOR hcKey,LPCTSTR pszValue,DWORD dwType, const BYTE *pData,DWORD cbData,HANDLE hSpooler) * fpSetValue;
  LONG( )(HKEYMONITOR hcKey,LPCTSTR pszValue,HANDLE hSpooler) *fpDeleteValue;
  LONG( )(HKEYMONITOR hcKey,DWORD dwIndex,LPTSTR pszValue,PDWORD pcbValue,PDWORD pTyp,PBYTE pData,PDWORD pcbData,HANDLE hSpooler) *fpEnumValue;
  LONG( )(HKEYMONITOR hcKey,LPCTSTR pszValue,PDWORD pType,PBYTE pData,PDWORD pcbData,HANDLE hSpooler) *fpQueryValue;
} MONITORREG, *PMONITORREG;

Membres

cbSize

Taille, en octets, de la structure MONITORREG .

fpCreateKey

Pointeur vers une fonction de registre du spouleur CreateKey .

fpOpenKey

Pointeur vers une fonction de registre du spouleur OpenKey .

fpCloseKey

Pointeur vers une fonction de registre du spouleur CloseKey .

fpDeleteKey

Pointeur vers une fonction de registre du spouleur DeleteKey .

fpEnumKey

Pointeur vers une fonction de registre du spouleur EnumKey .

fpQueryInfoKey

Pointeur vers une fonction de registre du spouleur QueryInfoKey .

fpSetValue

Pointeur vers une fonction de registre du spouleur SetValue .

fpDeleteValue

Pointeur vers une fonction de registre du spouleur DeleteValue .

fpEnumValue

Pointeur vers une fonction de registre du spouleur EnumValue .

fpQueryValue

Pointeur vers une fonction de registre du spouleur QueryValue .

Remarques

L’adresse de la structure MONITORREG est fournie dans une structure MONITORINIT , qui est passée à la fonction InitializePrintMonitor2 d’un moniteur d’impression.

Lors du stockage des informations de configuration de port, les moniteurs d’impression ne doivent pas appeler explicitement l’API de Registre Win32 ou l’API de registre de cluster.

Le spouleur contient une copie du Registre. N’utilisez pas l’API de Registre Win32 pour obtenir la valeur réellement utilisée par le spouleur. Utilisez les fonctions de Registre du spouleur répertoriées ci-dessous dont les pointeurs sont contenus dans la structure MONITORREG .

Au lieu de cela, ils doivent appeler des fonctions de registre du spouleur équivalentes. La structure MONITORREG fournit les adresses de ces fonctions. Le tableau suivant répertorie chaque fonction de registre du spouleur et sa fonction de registre de cluster équivalente.

Fonction de registre du spouleur	Fonction de registre de cluster équivalente
CreateKey	ClusterRegCreateKey
OpenKey	ClusterRegOpenKey
CloseKey	ClusterRegCloseKey
DeleteKey	ClusterRegDeleteKey
EnumKey	ClusterRegEnumKey
QueryInfoKey	ClusterRegQueryInfoKey
SetValue	ClusterRegSetValue
DeleteValue	ClusterRegDeleteValue
EnumValue	ClusterRegEnumValue
QueryValue	ClusterRegQueryValue

Les paramètres d’entrée et de sortie de ces fonctions spouleur correspondent aux paramètres des fonctions de Registre de cluster équivalentes dans l’en-tête clusapi.h , avec les exceptions suivantes :

• Chaque fonction de registre du spouleur nécessite un paramètre d’entrée hSpooler . Il s’agit du handle du spouleur reçu dans la structure MONITORINIT .

• Les fonctions de registre du spouleur utilisent des types de paramètres HANDLE et PHANDLE au lieu des types HKEY et PHKEY utilisés par les fonctions de Registre de cluster. Les moniteurs reçoivent le handle de l’emplacement du Registre racine dans le membre hckRegistryRoot de la structure MONITORINIT .

Configuration requise

Condition requise	Valeur
En-tête	winsplp.h (inclure Winsplp.h)

Voir aussi

InitializePrintMonitor2

MONITORINIT