Método IShellIconOverlayManager::GetReservedOverlayInfo (shlobj_core.h)

Artigo
08/26/2023

Obtém o índice da sobreposição de ícone ou a imagem de ícone do arquivo especificado com os atributos especificados de uma das sobreposições reservadas.

Sintaxe

HRESULT GetReservedOverlayInfo(
  [in, optional] PCWSTR pwszPath,
                 DWORD  dwAttrib,
  [out]          int    *pIndex,
                 DWORD  dwflags,
                 int    iReservedID
);

Parâmetros

[in, optional] pwszPath

Tipo: PCWSTR

O caminho completo do arquivo.

dwAttrib

Tipo: DWORD

Os atributos do arquivo. Esse parâmetro pode ser uma combinação de qualquer um dos sinalizadores de atributo de arquivo (FILE_ATTRIBUTE_*) definidos nos arquivos de cabeçalho do Windows. Consulte Constantes de atributo de arquivo.

[out] pIndex

Tipo: int*

O índice da imagem de ícone ou sobreposição de ícone, dependendo do valor de dwflags.

dwflags

Tipo: DWORD

Para o índice da sobreposição de ícone, use SIOM_OVERLAYINDEX. Para o índice da imagem de ícone, use SIOM_ICONINDEX.

iReservedID

Tipo: int

A ID de sobreposição do ícone reservado.

Valor retornado

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O índice apropriado foi encontrado.
E_FAIL	Falha, por qualquer motivo.

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	shlobj_core.h
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

IShellIconOverlay

IShellIconOverlayManager