Función AddPrintProvidor
Importante
El 6 de julio de 2021, KB5005010 introdujo una opción de configuración opcional basada en el Registro para restringir el acceso a esta API solo a los usuarios administradores. Esta opción estaba desactivada como predeterminada.
El 10 de agosto de 2021, KB5005652 cambia el valor predeterminado de esta configuración para requerir derechos de administrador para instalar nuevos controladores de impresora.
La función AddPrintProvidor instala un proveedor de impresión local y vincula los archivos de configuración, datos y proveedor.
Sintaxis
BOOL AddPrintProvidor(
_In_ LPTSTR pName,
_In_ DWORD Level,
_In_ LPBYTE pProviderInfo
);
Parámetros
-
pName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del servidor en el que se debe instalar el proveedor. En el caso de los sistemas que solo admiten la instalación local de proveedores, este parámetro debe ser NULL.
-
Nivel [in]
-
Nivel de la estructura a la que apunta pProviderInfo . Puede ser uno de los siguientes.
Valor Significado - 1
La función usa una estructura de PROVIDOR_INFO_1 . - 2
La función usa una estructura de PROVIDOR_INFO_2 . -
pProviderInfo [in]
-
Puntero a una estructura del proveedor de impresión, como se indica en Level.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
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.
Antes de que una aplicación llame a la función AddPrintProvidor , todos los archivos requeridos por el proveedor deben copiarse en el directorio SYSTEM32.
Se puede quitar un proveedor agregado por AddPrintProvidor llamando a DeletePrintProvidor.
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 |
AddPrintProvidorW (Unicode) y AddPrintProvidorA (ANSI) |