Método IShellImageDataFactory::GetDataFormatFromPath (shimgdata.h)

  • Artigo

Determina o formato de um arquivo com base em sua extensão.

Sintaxe

HRESULT GetDataFormatFromPath(
  [in]  LPCWSTR pszPath,
  [out] GUID    *pDataFormat
);

Parâmetros

[in] pszPath

Tipo: LPCWSTR

Um caminho para o arquivo.

[out] pDataFormat

Tipo: GUID*

Um ponteiro para um GUID que identifica o formato de imagem do arquivo.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, incluindo o seguinte:

Código de retorno Descrição
E_FAIL
 O parâmetro pszPath é NULL, a extensão de nome de arquivo não corresponde a nenhum decodificador GDI+ definido ou ocorreu um erro interno. Em qualquer um desses casos, pDataFormat é definido como GUID_NULL.
E_OUTOFMEMORY
 O objeto interno não pode ser instanciado.

Comentários

IShellImageDataFactory::GetDataFormatFromPath só deve ser usado para determinar se os dados podem ser salvos em um formato específico no sistema atual.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shimgdata.h
DLL Shell32.dll