Función DeletePrinterData
La función DeletePrinterData elimina los datos de configuración especificados para una impresora. Los datos de configuración de una impresora constan de un conjunto de valores con nombre y con tipo. La función DeletePrinterData elimina uno de estos valores, especificado por su nombre de valor.
Llamar a DeletePrinterData equivale a llamar a la función DeletePrinterDataEx con el parámetro pKeyName establecido en "PrinterDriverData".
Sintaxis
DWORD DeletePrinterData(
_In_ HANDLE hPrinter,
_In_ LPTSTR pValueName
);
Parámetros
-
hPrinter [in]
-
Identificador de la impresora cuyos datos de configuración se van a eliminar. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.
-
pValueName [in]
-
Puntero al nombre terminado en null del valor de datos de configuración 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 |
DeletePrinterDataW (Unicode) y DeletePrinterDataA (ANSI) |