Função OleLoadPicturePath (olectl.h)

Cria um novo objeto de imagem e o inicializa do conteúdo de um fluxo. Isso é equivalente a chamar OleCreatePictureIndirect(NULL, ...) seguido por IPersistStream::Load.

Sintaxe

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

Parâmetros

[in] szURLorPath

O caminho ou a URL para o arquivo que você deseja abrir.

[in] punkCaller

Aponta para IUnknown para agregação COM.

[in] dwReserved

Reservado.

[in] clrReserved

A cor que você deseja reservar para ser transparente.

[in] riid

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

[out] ppvRet

Endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, *ppvRet contém o ponteiro de interface solicitado no armazenamento do objeto identificado pelo moniker. Se *ppvRet não for NULL, essa função chamará IUnknown::AddRef na interface; é responsabilidade do chamador chamar IUnknown::Release. Se ocorrer um erro, *ppvRet será definido como NULL.

Valor retornado

Essa função dá suporte aos valores retornados padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os seguintes:

Código de retorno	Descrição
S_OK	A caixa de diálogo foi criada com êxito.
E_FAIL	Não é possível carregar o fluxo de imagens.
E_POINTER	O endereço em ppvRet é NULL.
E_NOINTERFACE	O objeto não dá suporte à interface especificada em riid.

Comentários

O fluxo deve estar no formato BMP (bitmap), JPEG, WMF (metarquivo), ICO (ícone) ou GIF.

Requisitos

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