AddPrintProvidor, fonction
Important
Le 6 juillet 2021, KB5005010 a introduit une option de configuration facultative basée sur le Registre pour restreindre l’accès à cette API aux utilisateurs administrateurs uniquement. Cette option était désactivée par défaut.
Le 10 août 2021, KB5005652 modifie la valeur par défaut de cette configuration pour exiger des droits d’administrateur pour installer de nouveaux pilotes d’imprimante.
La fonction AddPrintProvidor installe un fournisseur d’impression local et lie les fichiers de configuration, de données et de fournisseur.
Syntaxe
BOOL AddPrintProvidor(
_In_ LPTSTR pName,
_In_ DWORD Level,
_In_ LPBYTE pProviderInfo
);
Paramètres
-
pName [in]
-
Pointeur vers une chaîne terminée par null qui spécifie le nom du serveur sur lequel le fournisseur doit être installé. Pour les systèmes qui prennent uniquement en charge l’installation locale des fournisseurs, ce paramètre doit être NULL.
-
Niveau [in]
-
Niveau de la structure vers laquelle pProviderInfo pointe. Il peut s’agir de l’un des éléments suivants.
Valeur Signification - 1
La fonction utilise une structure PROVIDOR_INFO_1 . - 2
La fonction utilise une structure PROVIDOR_INFO_2 . -
pProviderInfo [in]
-
Pointeur vers une structure de fournisseur d’impression, comme indiqué par Level.
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Notes
Notes
Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote d’imprimante qui sont difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.
Avant qu’une application appelle la fonction AddPrintProvidor , tous les fichiers requis par le fournisseur doivent être copiés dans le répertoire SYSTEM32.
Un fournisseur ajouté par AddPrintProvidor peut être supprimé en appelant DeletePrintProvidor.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
AddPrintProvidorW (Unicode) et AddPrintProvidorA (ANSI) |