Méthode IPrintOemPrintTicketProvider ::QueryDeviceDefaultNamespace (prcomoem.h)
La méthode IPrintOemPrintTicketProvider ::QueryDeviceDefaultNamespace interroge l’appareil pour son URI (Uniform Resource Identifier) d’espace de noms par défaut.
Syntaxe
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
Paramètres
[out] pbstrNamespaceUri
Pointeur vers un BSTR qui reçoit l’URI de l’espace de noms. Le plug-in place l’URI de l’espace de noms dans la mémoire tampon vers laquelle pointe pbstrNamespaceUri. IPrintOemPrintTicketProvider ::QueryDeviceDefaultNamespace est responsable de l’allocation de la chaîne au moyen d’un appel à SysAllocString (décrit dans la documentation Microsoft Windows SDK), mais l’appelant est responsable de la libération de la chaîne.
Valeur retournée
IPrintOemPrintTicketProvider ::QueryDeviceDefaultNamespace doit retourner l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
| S_OK | L’opération a réussi. |
| E_NOTIMPL | Le plug-in n’a pas l’intention de remplacer l’espace de noms par défaut généré par le pilote principal à partir du fournisseur du plug-in. |
Remarques
Le plug-in doit spécifier le nom de l’URI de l’espace de noms privé que le pilote principal doit utiliser pour gérer toutes les fonctionnalités définies dans le fichier GPD ou le fichier PPD que le pilote principal ne reconnaît pas. Le plug-in peut spécifier un ensemble d’espaces de noms à la suite de l’appel à la méthode IPrintOemPrintTicketProvider ::BindPrinter . L’objectif de iPrintOemPrintTicketProvider ::QueryDeviceDefaultNamespace est d’informer le pilote principal sur l’espace de noms à utiliser comme espace de noms par défaut. Le pilote principal associe toutes les fonctionnalités qu’il ne reconnaît pas à cet espace de noms par défaut et place ces fonctionnalités dans le ticket d’impression.
Lorsque IPrintOemPrintTicketProvider ::QueryDeviceDefaultNamespace retourne, le pilote principal est chargé d’ajouter l’URI d’espace de noms privé que le plug-in a spécifié (dans *pbstrNamespaceUri) au nœud racine du document DOM. Le pilote principal doit également définir un préfixe pour l’espace de noms privé que le plug-in doit utiliser lorsque le plug-in ajoute un nouveau nœud au ticket d’impression sous l’espace de noms privé du plug-in. Le plug-in ne doit pas définir son propre préfixe pour cet URI d’espace de noms privé par défaut.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | prcomoem.h (include Prcomoem.h) |