Funzione DsGetIcon (dsclient.h)
La funzione DsGetIcon ottiene l'icona per una determinata classe oggetto. questa funzione è obsoleta. Le nuove applicazioni devono usare il metodo IDsDisplaySpecifier::GetIcon per eseguire questa funzione.
Sintassi
HICON DsGetIcon(
[in] DWORD dwFlags,
[in] LPCWSTR pszObjectClass,
[in] INT cxImage,
[in] INT cyImage
);
Parametri
[in] dwFlags
Contiene un set di flag che indicano il tipo di icona da recuperare. Questa può essere una combinazione di uno o più dei valori seguenti.
DSGIF_ISNORMAL
Ottiene l'icona normale per la classe oggetto.
DSGIF_ISOPEN
Ottiene l'icona aperta, ad esempio una cartella aperta, per la classe oggetto. Se la classe oggetto non ha un'icona aperta, questa funzione tenta di ottenere la normale icona per la classe oggetto.
DSGIF_ISDISABLED
Ottiene l'icona disabilitata, ad esempio un utente disabilitato, per la classe oggetto. Se la classe oggetto non ha un'icona disabilitata, questa funzione tenta di ottenere l'icona normale per la classe oggetto.
DSGIF_GETDEFAULTICON
Se non è possibile trovare alcuna icona per la classe oggetto, questa funzione restituirà un'icona predefinita. Se questo flag non è specificato e non è possibile trovare alcuna icona per la classe oggetto, questa funzione restituisce NULL.
DSGIF_DEFAULTISCONTAINER
Se non è possibile trovare alcuna icona per la classe oggetto, questa funzione restituisce l'icona del contenitore come icona predefinita. Se questo flag non è specificato e non è possibile trovare alcuna icona per la classe oggetto, questa funzione restituisce NULL.
[in] pszObjectClass
Puntatore a una stringa Unicode con terminazione null contenente il nome della classe oggetto per recuperare l'icona per. Esempi del nome della classe oggetto sono "user" e "container".
[in] cxImage
Contiene la larghezza desiderata, in pixel, dell'icona. Questa funzione recupera l'icona che corrisponde più strettamente a questa larghezza.
[in] cyImage
Contiene l'altezza desiderata, in pixel, dell'icona. Questa funzione recupera l'icona che corrisponde più strettamente a questa altezza.
Valore restituito
Restituisce un handle all'icona se ha esito positivo o NULL in caso contrario. Il chiamante deve distruggere questa icona quando non è più necessario passando questo handle a DestroyIcon.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | dsclient.h |
| Libreria | Dsuiext.lib |
| DLL | Dsuiext.dll |