Função SHLoadNonloadedIconOverlayIdentifiers (shellapi.h)

Sinaliza ao Shell que, durante a próxima operação que exige informações de sobreposição, ele deve carregar identificadores de sobreposição de ícone que falharam na criação ou não estavam presentes para criação na inicialização. Identificadores que já foram carregados não são afetados.

Sintaxe

SHSTDAPI SHLoadNonloadedIconOverlayIdentifiers();

Retornar valor

Tipo: HRESULT

Sempre retorna S_OK.

Comentários

Uma chamada para SHLoadNonloadedIconOverlayIdentifiers não resulta no carregamento imediato de uma extensão do Shell nem faz com que um manipulador de sobreposição de ícone seja carregado. Uma chamada para SHLoadNonloadedIconOverlayIdentifiers resulta em uma situação de modo que o próximo código para solicitar informações de sobreposição de ícone dispara uma comparação de sobreposições de ícone no registro para aquelas que já estão carregadas. Se uma sobreposição de ícone for registrada recentemente e o sistema ainda não tiver atingido seu limite superior de quinze sobreposições de ícone, a nova sobreposição será carregada. SHLoadNonloadedIconOverlayIdentifiers sozinho não carrega uma nova sobreposição de ícone; você também precisa disparar uma ação que usa a sobreposição, como uma atualização de uma exibição do Windows Explorer.

Para obter mais informações, confira Como implementar manipuladores de sobreposição de ícone.

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