Metodo IDsDisplaySpecifier::GetIconLocation (dsclient.h)

Il metodo IDsDisplaySpecifier::GetIconLocation ottiene la posizione dell'icona per una determinata classe oggetto. La posizione dell'icona include il nome del file e l'identificatore della risorsa.

Sintassi

HRESULT GetIconLocation(
  [in]      LPCWSTR pszObjectClass,
  [in]      DWORD   dwFlags,
  [in, out] LPWSTR  pszBuffer,
  [in]      INT     cchBuffer,
  [in, out] INT     *presid
);

Parametri

[in] pszObjectClass

Puntatore a una stringa Unicode con terminazione null contenente il nome della classe oggetto per cui ottenere la posizione dell'icona. 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 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_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 un'icona per la classe oggetto, questo metodo restituisce 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, out] pszBuffer

Puntatore a un buffer di caratteri wide che riceve il percorso e il nome file del file che contiene l'icona. Questo buffer deve essere almeno cchBuffer wide caratteri in lunghezza.

[in] cchBuffer

Contiene le dimensioni del buffer pszBuffer , in caratteri wide, incluso il carattere NULL terminante. Se il nome del file supera questo numero di caratteri, il nome del file viene troncato.

[in, out] presid

Puntatore a un valore INT che riceve l'identificatore di risorsa o l'indice dell'icona. Se questo valore è positivo, il valore è l'indice dell'icona nel file. Se questo valore è negativo, il valore assoluto di questo valore è l'identificatore della risorsa dell'icona nel file.

Valore restituito

Restituisce un valore HRESULT standard, incluso quanto segue.

Requisiti

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

Vedi anche

Visualizzare le interfacce in Active Directory Domain Services

IDDisplaySpecifier

IDDisplaySpecifier::GetIcon