OleCreateFontIndirect, fonction (olectl.h)

Crée et initialise un objet de police standard à l’aide d’une description initiale des propriétés de la police dans une structure FONTDESC . La fonction retourne un pointeur d’interface vers le nouvel objet de police spécifié par l’appelant dans le paramètre riid. Un appel QueryInterface fait partie de cet appel. L’appelant est responsable de l’appel de Release via le pointeur d’interface retourné.

Syntaxe

WINOLECTLAPI OleCreateFontIndirect(
  [in]  LPFONTDESC lpFontDesc,
  [in]  REFIID     riid,
  [out] LPVOID     *lplpvObj
);

Paramètres

[in] lpFontDesc

Adresse d’une structure FONTDESC allouée par l’appelant contenant l’état initial de la police. Cette valeur ne doit pas être NULL.

[in] riid

Référence à l’identificateur de l’interface décrivant le type de pointeur d’interface à retourner dans lplpvObj.

[out] lplpvObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. En cas de retour réussi, ce paramètre contient le pointeur d’interface demandé sur l’objet de police nouvellement créé. En cas de réussite, l’appelant est chargé d’appeler Release via ce pointeur d’interface lorsque le nouvel objet n’est plus nécessaire. En cas d’échec, la valeur de est définie sur NULL.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour Description
E_NOINTERFACE
L’identificateur d’interface fourni n’est pas valide.
E_UNEXPECTED
Une erreur inattendue s’est produite.
E_OUTOFMEMORY
Mémoire insuffisante pour l’opération.
E_INVALIDARG
Un ou plusieurs paramètres ne sont pas valides.
E_POINTER
L’adresse dans pFontDesc ou ppvObj n’est pas valide. Notez que si pFontDesc a la valeur NULL, la fonction retourne NO_ERROR.

Configuration requise

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]
Plateforme cible Windows
En-tête olectl.h
Bibliothèque OleAut32.lib
DLL OleAut32.dll

Voir aussi

FONTDESC