IPrintCoreHelperUni ::EnumConstrainedOptions, méthode (prcomoem.h)
La méthode IPrintCoreHelperUni ::EnumConstrainedOptions fournit une liste de toutes les options limitées dans une fonctionnalité particulière, en fonction des paramètres actuels.
Syntaxe
HRESULT EnumConstrainedOptions(
[in, optional] IN const DEVMODE *pDevmode,
[in] IN DWORD cbSize,
[in] IN PCSTR pszFeatureKeyword,
[out] OUT PCSTR * [] pConstrainedOptionList,
[out] OUT DWORD *pdwNumOptions
);
Paramètres
[in, optional] pDevmode
Pointeur vers une structure DEVMODEW. Si ce pointeur est fourni, IPrintCoreHelperUni ::EnumConstrainedOptions devez utiliser la structure DEVMODEW pointée par pDevmode au lieu de la structure DEVMODEW par défaut ou actuelle. Si cette méthode est appelée à partir du fournisseur de plug-in ou de IPrintOemUni ::D evMode, ce paramètre est requis. Dans la plupart des autres cas, le paramètre doit être NULL. Lorsque le pilote principal définit pDevmode sur NULL, il modifie son état interne plutôt que celui de la structure DEVMODEW passée. Cela est nécessaire pendant les opérations telles que le remplacement complet de l’interface utilisateur, où la structure DEVMODEW retournée par une DDI, telle que DrvDocumentPropertySheets, est en cours de service par le module d’interface utilisateur du pilote principal.
[in] cbSize
Taille, en octets, de la structure DEVMODEW pointée par le paramètre pDevmode.
[in] pszFeatureKeyword
Chaîne de caractères ANSI qui contient le nom de la fonctionnalité.
[out] pConstrainedOptionList
Pointeur vers un tableau de chaînes de caractères ANSI. Lorsque IPrintCoreHelperUni ::EnumConstrainedOptions retourne, ces chaînes contiennent les noms de toutes les options limitées dans la fonctionnalité spécifiée. L’appelant n’est pas responsable de la libération du tableau ou des chaînes individuelles dans le tableau.
[out] pdwNumOptions
Pointeur vers une variable qui reçoit le nombre d’options contraintes dans le tableau vers lequel pointe le paramètre pConstrainedOptionList.
Valeur de retour
IPrintCoreHelperUni ::EnumConstrainedOptions doit retourner l’une des valeurs suivantes.
| Retourner le code | Description |
|---|---|
| S_OK | Les options contraintes ont été définies pour la fonctionnalité spécifiée. |
| E_FAIL | L’appelant a fourni des informations qui ont entraîné une demande non valide, telle qu’une demande d’une fonctionnalité qui n’existe pas. |
| E_INVALIDARG | Un ou plusieurs arguments n’étaient pas valides. Cette valeur peut signifier que la fonctionnalité n’est pas prise en charge. |
| E_OUTOFMEMORY | Il n’y avait pas suffisamment de mémoire pour créer le tableau d’options ou le pilote principal n’a pas pu traiter la requête en raison d’un manque de mémoire. |
| E_UNEXPECTED ou d’autres échecs non répertoriés ici | Une condition inattendue s’est produite. Le pilote principal est probablement dans un état non valide. L’appelant doit se quitter avec un code d’échec. |
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |