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

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