GetPrinterDriverPackagePath, fonction
Récupère le chemin d’accès au package de pilote d’imprimante spécifié sur un serveur d’impression.
HRESULT GetPrinterDriverPackagePath(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszEnvironment,
_In_ LPCTSTR pszLanguage,
_In_ LPCTSTR pszPackageID,
_Inout_ LPTSTR pszDriverPackageCab,
_In_ DWORD cchDriverPackageCab,
_Out_ LPDWORD pcchRequiredSize
);
-
pszServer [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie le nom du serveur d’impression. Utilisez NULL pour l’ordinateur local.
-
pszEnvironment [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie l’architecture du processeur (par exemple, Windows NT x86). Il peut s’agir de NULL.
-
pszLanguage [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie la langue de l’interface utilisateur multilingue pour le pilote en cours d’installation. Il peut s’agir de NULL.
-
pszPackageID [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie l’ID du package de pilotes.
-
pszDriverPackageCab [in, out]
-
Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès au fichier d’armoire pour le package de pilotes. Il peut s’agir de NULL. Consultez la section Notes.
-
cchDriverPackageCab [in]
-
Taille, en caractères, de la mémoire tampon pszDriverPackageCab . Il peut s’agir de NULL.
-
pcchRequiredSize [out]
-
Pointeur vers la taille requise de la mémoire tampon pszDriverPackageCab .
Si l’opération réussit, la valeur de retour est S_OK, sinon le HRESULT contient un code d’erreur.
Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.
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.
Pour obtenir une valeur pour cchDriverPackageCab, appelez la fonction avec NULL comme valeur de pszDriverPackageCab. Utilisez la valeur retournée dans pcchRequiredSize comme valeur de cchDriverPackageCab et appelez à nouveau la fonction.
Le pszPackageID est généralement obtenu à partir d’un appel à GetCorePrinterDrivers.
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
En-tête |
|
Bibliothèque |
|
DLL |
|
Noms Unicode et ANSI |
GetPrinterDriverPackagePathW (Unicode) et GetPrinterDriverPackagePathA (ANSI) |