Estructura MONITORREG (winsplp.h)
La estructura MONITORREG proporciona monitores de impresión con la dirección de las funciones del Registro que se usarán en lugar de las funciones de API del Registro win32.
Sintaxis
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;
Miembros
cbSize
Tamaño, en bytes, de la estructura MONITORREG .
fpCreateKey
Puntero a una función del registro createKey spooler.
fpOpenKey
Puntero a una función del Registro de cola de OpenKey .
fpCloseKey
Puntero a una función del registro CloseKey spooler.
fpDeleteKey
Puntero a una función del registro deleteKey spooler.
fpEnumKey
Puntero a una función del Registro de cola de EnumKey .
fpQueryInfoKey
Puntero a una función del registro queryInfoKey spooler.
fpSetValue
Puntero a una función del Registro setValue spooler.
fpDeleteValue
Puntero a una función del Registro deleteValue spooler.
fpEnumValue
Puntero a una función del Registro de cola de EnumValue .
fpQueryValue
Puntero a una función del Registro queryValue spooler.
Comentarios
La dirección de la estructura MONITORREG se proporciona en una estructura MONITORINIT , que se pasa a la función InitializePrintMonitor2 de un monitor de impresión.
Al almacenar información de configuración de puerto, los monitores de impresión no deben llamar explícitamente a la API del registro win32 ni a la API del registro del clúster.
El administrador de colas contiene una copia del Registro. No use la API del Registro Win32 para obtener el valor que realmente usa el administrador de colas. Use las funciones del registro de cola enumeradas a continuación cuyos punteros están incluidos en la estructura MONITORREG .
En su lugar, deben llamar a funciones de registro de cola equivalentes. La estructura MONITORREG proporciona las direcciones de estas funciones. En la tabla siguiente se enumeran cada función del registro de cola y su función de registro de clúster equivalente.
| Función del registro Spooler | Función de registro de clúster equivalente |
|---|---|
| CreateKey | ClusterRegCreateKey |
| Openkey | ClusterRegOpenKey |
| CloseKey | ClusterRegCloseKey |
| DeleteKey | ClusterRegDeleteKey |
| EnumKey | ClusterRegEnumKey |
| QueryInfoKey | ClusterRegQueryInfoKey |
| SetValue | ClusterRegSetValue |
| DeleteValue | ClusterRegDeleteValue |
| EnumValue | ClusterRegEnumValue |
| QueryValue | ClusterRegQueryValue |
Los parámetros de entrada y salida de estas funciones de cola coinciden con los parámetros de las funciones del registro de clúster equivalentes en el encabezado clusapi.h , con las siguientes excepciones:
Cada función del registro de cola requiere un parámetro de entrada hSpooler . Este es el identificador de cola recibido en la estructura MONITORINIT .
Las funciones del registro de cola usan los tipos de parámetro HANDLE y PHANDLE en lugar de los tipos HKEY y PHKEY usados por las funciones del registro de clúster. Los monitores reciben el identificador de la ubicación del Registro raíz en el miembro hckRegistryRoot de la estructura MONITORINIT .
Requisitos
| Requisito | Valor |
|---|---|
| Header | winsplp.h (incluya Winsplp.h) |