Struttura MONITORREG (winsplp.h)

  • Articolo

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)

Vedi anche

InitializePrintMonitor2

MONITORINIT