Função OleCreateFontIndirect (olectl.h)

  • Artigo

Cria e inicializa um objeto de fonte padrão usando uma descrição inicial das propriedades da fonte em uma estrutura FONTDESC . A função retorna um ponteiro de interface para o novo objeto de fonte especificado pelo chamador no parâmetro riid. Uma chamada QueryInterface faz parte dessa chamada. O chamador é responsável por chamar Release por meio do ponteiro de interface retornado.

Sintaxe

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

Parâmetros

[in] lpFontDesc

Endereço de uma estrutura FONTDESC alocada pelo chamador que contém o estado inicial da fonte. Esse valor não deve ser NULL.

[in] riid

Referência ao identificador da interface que descreve o tipo de ponteiro de interface a ser retornado em lplpvObj.

[out] lplpvObj

Endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, esse parâmetro contém o ponteiro de interface solicitado no objeto de fonte recém-criado. Se tiver êxito, o chamador será responsável por chamar Release por meio desse ponteiro de interface quando o novo objeto não for mais necessário. Se não for bem-sucedido, o valor de será definido como NULL.

Retornar valor

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
E_NOINTERFACE
 O identificador de interface fornecido é inválido.
E_UNEXPECTED
 Ocorreu um erro inesperado.
E_OUTOFMEMORY
 Memória insuficiente para a operação.
E_INVALIDARG
Um ou mais parâmetros são inválidos.
E_POINTER
 O endereço em pFontDesc ou ppvObj não é válido. Observe que, se pFontDesc estiver definido como NULL, a função retornará NO_ERROR.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho olectl.h
Biblioteca OleAut32.lib
DLL OleAut32.dll

Confira também

FONTDESC