Función OleCreateFontIndirect (olectl.h)

  • Artículo

Crea e inicializa un objeto de fuente estándar utilizando una descripción inicial de las propiedades de la fuente en una estructura FONTDESC . La función devuelve un puntero de interfaz al nuevo objeto de fuente especificado por el llamador en el parámetro riid. Una llamada QueryInterface forma parte de esta llamada. El autor de la llamada es responsable de llamar a Release a través del puntero de interfaz devuelto.

Sintaxis

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

Parámetros

[in] lpFontDesc

Dirección de una estructura FONTDESC asignada por el autor de la llamada que contiene el estado inicial de la fuente. Este valor no debe ser NULL.

[in] riid

Referencia al identificador de la interfaz que describe el tipo de puntero de interfaz que se va a devolver en lplpvObj.

[out] lplpvObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, este parámetro contiene el puntero de interfaz solicitado en el objeto de fuente recién creado. Si se ejecuta correctamente, el autor de la llamada es responsable de llamar a Release a través de este puntero de interfaz cuando el nuevo objeto ya no es necesario. Si no se realiza correctamente, el valor de se establece en NULL.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son los siguientes.

Código devuelto Descripción
E_NOINTERFACE
 El identificador de interfaz proporcionado no es válido.
E_UNEXPECTED
 Se produjo un error inesperado.
E_OUTOFMEMORY
 Memoria insuficiente para la operación.
E_INVALIDARG
Uno o varios parámetros no son válidos.
E_POINTER
 La dirección de pFontDesc o ppvObj no es válida. Tenga en cuenta que si pFontDesc se establece en NULL, la función devuelve NO_ERROR.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado olectl.h
Library OleAut32.lib
Archivo DLL OleAut32.dll

Consulte también

FONTDESC