OleCreateFontIndirect, fonction (olectl.h)

Article
03/01/2024

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

Partager via