Metodo IShellImageData::D ecode (shimgdata.h)

Articolo
03/02/2024

Decodifica il file di immagine, impostando lo stato.

Sintassi

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

Parametri

[in] dwFlags

Tipo: DWORD

Uno dei flag seguenti.

SHIMGDEC_DEFAULT (0x00)

Creare un'immagine completa.

SHIMGDEC_THUMBNAIL (0x01)

Decodifica solo l'immagine di anteprima.

SHIMGDEC_LOADFULL (0x02)

Caricare l'intero file di immagine in memoria.

[in] cxDesired

Tipo: ULONG

Dimensione orizzontale desiderata dell'immagine decodificata. Questo parametro viene usato solo se il flag di SHIMGDEC_THUMBNAIL è impostato. Se il flag di SHIMGDEC_DEFAULT è impostato, questo valore viene ignorato.

[in] cyDesired

Tipo: ULONG

Dimensioni verticali desiderate dell'immagine decodificata. Questo parametro viene usato solo se il flag di SHIMGDEC_THUMBNAIL è impostato. Se il flag di SHIMGDEC_DEFAULT è impostato, questo valore viene ignorato.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Codice restituito	Descrizione
E_FAIL	Impossibile caricare il file o l'applicazione chiamante ha arrestato il processo di decodifica tramite una chiamata a un IShellImageDataAbort registrato (vedere IShellImageData::RegisterAbort per altre informazioni).
E_OUTOFMEMORY	Impossibile creare un'istanza dell'oggetto interno.
E_NOTIMPL	Il percorso usato per creare questa istanza di IShellImageData era un URL.
S_FALSE	L'immagine è già stata decodificata.

Commenti

IShellImageData::D ecode deve essere chiamato prima di chiamare la maggior parte dei metodi IShellImageData . In questo modo non si verifica un errore di tali metodi.

IShellImageData::D ecode tenta di mantenere il rapporto di aspetto dell'immagine originale, quindi uno dei valori passati in cxDesired o cyDesired potrebbe essere sottoposto a override.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shimgdata.h
DLL	Shell32.dll

Condividi tramite