Função OleCreateFontIndirect (olectl.h)
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 |
---|---|
|
O identificador de interface fornecido é inválido. |
|
Ocorreu um erro inesperado. |
|
Memória insuficiente para a operação. |
|
Um ou mais parâmetros são inválidos. |
|
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 |