Método IPicture::get_Handle (ocidl.h)

  • Artigo

Recupera o identificador para a imagem gerenciada dentro desse objeto de imagem para um local especificado.

Sintaxe

HRESULT get_Handle(
  [out] OLE_HANDLE *pHandle
);

Parâmetros

[out] pHandle

Um ponteiro para uma variável que recebe o identificador. O chamador é responsável por esse identificador após o retorno bem-sucedido. A variável é definida como NULL em caso de falha.

Retornar valor

Esse método dá suporte aos valores retornados padrão E_FAIL e E_OUTOFMEMORY, bem como aos valores a seguir.

Código de retorno Descrição
S_OK
 O identificador foi retornado com êxito.
E_POINTER
 O valor de phandle não é válido. Por exemplo, pode ser NULL.

Comentários

Anotações aos Chamadores

O objeto de imagem pode manter a propriedade da imagem. No entanto, o chamador pode ter certeza de que a imagem permanecerá válida até que o chamador destrua especificamente a imagem ou o objeto de imagem seja destruído. O parâmetro fOwn para OleCreatePictureIndirect determina a propriedade quando o objeto de imagem é criado. OleLoadPicture força fOwn a TRUE.

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 ocidl.h

Confira também

Ipicture