IPrintOemUI ::GetInfo, méthode (prcomoem.h)
La méthode IPrintOemUI::GetInfo d’un plug-in d’interface utilisateur retourne des informations d’identification.
Syntaxe
HRESULT GetInfo(
DWORD dwMode,
PVOID pBuffer,
DWORD cbSize,
PDWORD pcbNeeded
);
Paramètres
dwMode
Contient l’une des constantes entières fournies par l’appelant suivant.
OEMGI_GETREQUESTEDHELPERINTERFACES
La méthode doit écrire la valeur d’indicateur de bits de OEMPUBLISH_IPRINTCOREHELPER dans la mémoire tampon pBuffer si la méthode IPrintOemUI ::P ublishDriverInterface doit être appelé avec le paramètre pIUnknown pointant vers un objet qui implémente l’interface IPrintCoreHelperPS ou iPrintCoreHelperUni Interface.
OEMGI_GETSIGNATURE
La méthode doit retourner une signature d’identification à quatre octets unique. Le plug-in doit également placer cette signature dans structures OPTITEM, comme décrit dans la description du membre oemCUIPPARAM structure pOEMOptItems.
OEMGI_GETVERSION
La méthode doit retourner le numéro de version du plug-in d’interface utilisateur en tant que DWORD. Le format de version est défini par le développeur.
pBuffer
Pointeur fourni par l’appelant vers la mémoire allouée pour recevoir les informations spécifiées par dwMode.
cbSize
Taille fournie par l’appelant de la mémoire tampon pointée par pBuffer .
pcbNeeded
Pointeur fourni par l’appelant vers un emplacement pour recevoir le nombre d’octets écrits dans la mémoire tampon pointée par pBuffer.
Valeur de retour
La méthode doit retourner l’une des valeurs suivantes.
| Retourner le code | Description |
|---|---|
|
L’opération a réussi. |
|
L’opération a échoué. |
|
La méthode n’est pas implémentée. |
Remarques
Les plug-ins d’interface utilisateur sont nécessaires pour implémenter la méthode IPrintOemUI::GetInfo, appelée immédiatement après le chargement du plug-in. La méthode doit renvoyer les informations spécifiées en l’écrivant à l’adresse spécifiée par pBuffer et en écrivant la taille, en octets, des informations retournées dans l’emplacement spécifié par .
Si pBuffer est NULL, la méthode doit simplement utiliser pour retourner le nombre d’octets requis pour stocker les informations spécifiées.
Pour plus d’informations sur la création et l’installation de plug-ins d’interface utilisateur, consultez Personnalisation des pilotes d’imprimantes microsoft.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |