Struttura MONITORREG (winsplp.h)
La struttura MONITORREG fornisce monitor di stampa con l'indirizzo delle funzioni del Registro di sistema da usare invece delle funzioni API del Registro di sistema Win32.
Sintassi
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;
Members
cbSize
Dimensioni, in byte, della struttura MONITORREG .
fpCreateKey
Puntatore a una funzione del Registro di sistema CreateKey spooler.
fpOpenKey
Puntatore a una funzione del Registro di sistema OpenKey spooler.
fpCloseKey
Puntatore a una funzione del Registro di sistema Dello spooler CloseKey .
fpDeleteKey
Puntatore a una funzione del Registro di sistema DeleteKey spooler.
fpEnumKey
Puntatore a una funzione del Registro di sistema Spooler EnumKey .
fpQueryInfoKey
Puntatore a una funzione del Registro di sistema dello spooler QueryInfoKey .
fpSetValue
Puntatore a una funzione del Registro di sistema SetValue spooler.
fpDeleteValue
Puntatore a una funzione del Registro di sistema DeleteValue spooler.
fpEnumValue
Puntatore a una funzione del Registro di sistema Spooler EnumValue .
fpQueryValue
Puntatore a una funzione del Registro di sistema dello spooler QueryValue .
Commenti
L'indirizzo della struttura MONITORREG viene fornito in una struttura MONITORINIT , che viene passata alla funzione InitializePrintMonitor2 di un monitor di stampa.
Quando si archiviano le informazioni di configurazione delle porte, i monitoraggi di stampa non devono chiamare in modo esplicito l'API del Registro di sistema Win32 o l'API del Registro di sistema del cluster.
Lo spooler contiene una copia del Registro di sistema. Non usare l'API del Registro di sistema Win32 per ottenere il valore effettivamente usato dallo spooler. Usare le funzioni del Registro di sistema spooler elencate di seguito i cui puntatori sono contenuti nella struttura MONITORREG .
Devono invece chiamare funzioni del Registro di sistema spooler equivalenti. La struttura MONITORREG fornisce gli indirizzi di queste funzioni. La tabella seguente elenca ogni funzione del Registro di sistema spooler e la relativa funzione del Registro di sistema del cluster equivalente.
| Funzione del Registro di sistema Spooler | Funzione del Registro di sistema del cluster equivalente |
|---|---|
| Createkey | ClusterRegCreateKey |
| OpenKey | ClusterRegOpenKey |
| CloseKey | ClusterRegCloseKey |
| DeleteKey | ClusterRegDeleteKey |
| EnumKey | ClusterRegEnumKey |
| QueryInfoKey | ClusterRegQueryInfoKey |
| SetValue | ClusterRegSetValue |
| DeleteValue | ClusterRegDeleteValue |
| Enumvalue | ClusterRegEnumValue |
| QueryValue | ClusterRegQueryValue |
I parametri di input e output per queste funzioni spooler corrispondono ai parametri delle funzioni del Registro di sistema del cluster equivalenti nell'intestazione clusapi.h , con le eccezioni seguenti:
Ogni funzione del Registro di sistema spooler richiede un parametro di input hSpooler . Si tratta dell'handle spooler ricevuto nella struttura MONITORINIT .
Le funzioni del Registro di sistema spooler usano i tipi di parametro HANDLE e PHANDLE anziché i tipi HKEY e PHKEY usati dalle funzioni del Registro di sistema del cluster. I monitoraggi ricevono l'handle del percorso del Registro di sistema radice nel membro hckRegistryRoot della struttura MONITORINIT .
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | winsplp.h (include Winsplp.h) |