Função OleCreatePictureIndirect (olectl.h)

  • Artigo

Cria um novo objeto de imagem inicializado de acordo com uma estrutura PICTDESC .

Sintaxe

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

Parâmetros

[in] lpPictDesc

Ponteiro para uma estrutura alocada pelo chamador que contém o estado inicial da imagem. A estrutura especificada pode ser NULL para criar um objeto não inicializado, caso a imagem precise ser inicializada por meio de IPersistStream::Load.

[in] riid

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

[in] fOwn

Se TRUE, o objeto de imagem será destruir sua imagem quando o objeto for destruído. Se FALSE, o chamador será responsável por destruir a imagem.

[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 recém-criado. Se a chamada for bem-sucedida, 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 a chamada falhar, o valor 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 objeto não dá suporte à interface especificada em riid.
E_POINTER
 O endereço em pPictDesc ou lplpvObj não é válido. Por exemplo, pode ser NULL.

Comentários

O parâmetro fOwn indica se a imagem deve ser proprietária do identificador de imagem GDI para a imagem que ela contém, para que o objeto de imagem destrua sua imagem quando o próprio objeto for destruído. A função retorna um ponteiro de interface para o novo objeto de imagem especificado pelo chamador no parâmetro riid . Um QueryInterface é integrado a essa chamada. O chamador é responsável por chamar Release por meio do ponteiro de interface retornado.

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

OleLoadPicture

PICTDESC