Método IDsDisplaySpecifier::GetIconLocation (dsclient.h)
O método IDsDisplaySpecifier::GetIconLocation obtém o local do ícone para uma determinada classe de objeto. O local do ícone inclui o nome do arquivo e o identificador de recurso.
Sintaxe
HRESULT GetIconLocation(
[in] LPCWSTR pszObjectClass,
[in] DWORD dwFlags,
[in, out] LPWSTR pszBuffer,
[in] INT cchBuffer,
[in, out] INT *presid
);
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 local do í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 uma ou mais das opções 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_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, out] pszBuffer
Ponteiro para um buffer de caracteres largos que recebe o caminho e o nome do arquivo que contém o ícone. Esse buffer deve ter pelo menos caracteres largos cchBuffer de comprimento.
[in] cchBuffer
Contém o tamanho do buffer pszBuffer, em caracteres largos, incluindo o caractere NULL de terminação. Se o nome do arquivo exceder esse número de caracteres, o nome do arquivo será truncado.
[in, out] presid
Ponteiro para um valor INT que recebe o identificador de recurso ou índice do ícone. Se esse valor for positivo, o valor será o índice do ícone no arquivo. Se esse valor for negativo, o valor absoluto desse valor será o identificador de recurso do ícone no arquivo.
Retornar valor
Retorna um valor HRESULT padrão, incluindo o seguinte.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |