Función DeletePrinterDataEx
La función DeletePrinterDataEx elimina un valor especificado de los datos de configuración de una impresora. Los datos de configuración de una impresora constan de un conjunto de valores con nombre y con tipo almacenados en una jerarquía de claves del Registro. La función elimina un valor especificado en una clave especificada.
Al igual que la función DeletePrinterData , DeletePrinterDataEx puede eliminar los valores almacenados por la función SetPrinterData . Además, DeletePrinterDataEx puede eliminar los valores almacenados en una clave especificada por la función SetPrinterDataEx .
Sintaxis
DWORD DeletePrinterDataEx(
_In_ HANDLE hPrinter,
_In_ LPCTSTR pKeyName,
_In_ LPCTSTR pValueName
);
Parámetros
-
hPrinter [in]
-
Identificador de la impresora para la que la función elimina un valor. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.
-
pKeyName [in]
-
Puntero a una cadena terminada en null que especifica la clave que contiene el valor que se va a eliminar. Use el carácter de barra diagonal inversa ( \ ) como delimitador para especificar una ruta de acceso que tenga una o varias subclaves.
Si pKeyName es NULL o una cadena vacía, DeletePrinterDataEx devuelve ERROR_INVALID_PARAMETER.
-
pValueName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del valor que se va a eliminar.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error del sistema.
Comentarios
Nota:
Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación del controlador de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DeletePrinterDataExW (Unicode) y DeletePrinterDataExA (ANSI) |