Metodo IDsDisplaySpecifier::GetIcon (dsclient.h)

Il metodo IDsDisplaySpecifier::GetIcon ottiene l'icona per una determinata classe oggetto.

Sintassi

HICON GetIcon(
  [in] LPCWSTR pszObjectClass,
  [in] DWORD   dwFlags,
  [in] INT     cxIcon,
  [in] INT     cyIcon
);

Parametri

[in] pszObjectClass

Puntatore a una stringa Unicode con terminazione null contenente il nome della classe oggetto per ottenere l'icona per. Esempi del nome della classe oggetto sono "user" e "container".

[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, questo metodo 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, questo metodo tenta di ottenere la normale icona per la classe oggetto.

DSGIF_ISMASK

Usato per mascherare i flag di DSGIF_ISNORMAL, DSGIF_ISOPEN e DSGIF_ISDISABLED .

DSGIF_GETDEFAULTICON

Se non è possibile trovare un'icona per la classe oggetto, questo metodo restituisce un'icona predefinita. Se questo flag non è specificato e non è disponibile alcuna icona per la classe oggetto, questo metodo restituisce NULL.

DSGIF_DEFAULTISCONTAINER

Se non è possibile trovare alcuna icona per la classe oggetto, questo metodo restituirà l'icona del contenitore come icona predefinita. Se questo flag non è specificato e non è disponibile alcuna icona per la classe oggetto, questo metodo restituisce NULL.

[in] cxIcon

Contiene la larghezza desiderata, in pixel, dell'icona. Questo metodo ottiene l'icona che corrisponde più strettamente a questa larghezza.

[in] cyIcon

Contiene l'altezza desiderata, in pixel, dell'icona. Questo metodo ottiene 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

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsclient.h
DLL	Dsadmin.dll

Vedi anche

DestroyIcon

Visualizzare le interfacce in Active Directory Domain Services

IDDisplaySpecifier