Método IDsDisplaySpecifier::GetIcon (dsclient.h)
O método IDsDisplaySpecifier::GetIcon obtém o ícone de uma determinada classe de objeto.
Sintaxe
HICON GetIcon(
[in] LPCWSTR pszObjectClass,
[in] DWORD dwFlags,
[in] INT cxIcon,
[in] INT cyIcon
);
Parâmetros
[in] pszObjectClass
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da classe de objeto para a qual obter o ícone. Exemplos do nome da classe de objeto são "user" e "container".
[in] dwFlags
Contém um conjunto de sinalizadores que indicam o tipo de ícone a ser recuperado. Isso pode ser uma combinação de um ou mais dos valores a seguir.
DSGIF_ISNORMAL
Obtém o ícone normal para a classe de objeto.
DSGIF_ISOPEN
Obtém o ícone aberto, como uma pasta aberta, para a classe de objeto . Se a classe de objeto não tiver um ícone aberto, esse método tentará obter o ícone normal para a classe de objeto.
DSGIF_ISDISABLED
Obtém o ícone desabilitado, como um usuário desabilitado, para a classe de objeto . Se a classe de objeto não tiver um ícone desabilitado, esse método tentará obter o ícone normal para a classe de objeto.
DSGIF_ISMASK
Usado para mascarar os sinalizadores DSGIF_ISNORMAL, DSGIF_ISOPEN e DSGIF_ISDISABLED .
DSGIF_GETDEFAULTICON
Se nenhum ícone puder ser encontrado para a classe de objeto, esse método retornará um ícone padrão. Se esse sinalizador não for especificado e nenhum ícone puder ser encontrado para a classe de objeto, esse método retornará NULL.
DSGIF_DEFAULTISCONTAINER
Se nenhum ícone puder ser encontrado para a classe de objeto, esse método retornará o ícone de contêiner como o ícone padrão. Se esse sinalizador não for especificado e nenhum ícone puder ser encontrado para a classe de objeto, esse método retornará NULL.
[in] cxIcon
Contém a largura desejada, em pixels, do ícone. Esse método obtém o ícone que mais corresponde a essa largura.
[in] cyIcon
Contém a altura desejada, em pixels, do ícone. Esse método obtém o ícone que mais corresponde a essa altura.
Valor retornado
Retorna um identificador para o ícone, se tiver êxito ou NULL caso contrário. O chamador deve destruir esse ícone quando ele não for mais necessário passando esse identificador para DestroyIcon.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | dsclient.h |
| DLL | Dsadmin.dll |