Método IAssocHandler::GetIconLocation (shobjidl_core.h)

Recupera o local do ícone associado ao aplicativo.

Sintaxe

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

Parâmetros

[out] ppszPath

Tipo: LPWSTR*

Quando esse método retorna, contém o endereço de um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho para o ícone do aplicativo.

[out] pIndex

Tipo: int*

Quando esse método retorna, contém um ponteiro para o índice do ícone dentro do recurso chamado em ppszPath.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se o ícone não puder ser encontrado, a função retornará o caminho para o executável e um índice de ícone de zero.

Por motivos de desempenho, um aplicativo pode usar o cache de imagem do Shell para recuperar o ícone, em vez de carregar o ícone diretamente do caminho retornado. O caminho e o índice de ícone podem ser passados diretamente para Shell_GetCachedImageIndex. Um benefício disso é que o cache do Shell pode fornecer um ícone padrão caso nenhum ícone estivesse disponível para o aplicativo.

Requisitos