IDsDisplaySpecifier::GetIcon-Methode (dsclient.h)

Die IDsDisplaySpecifier::GetIcon-Methode ruft das Symbol für eine bestimmte Objektklasse ab.

Syntax

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

Parameter

[in] pszObjectClass

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen der Objektklasse enthält, für die das Symbol abgerufen werden soll. Beispiele für den Objektklassennamen sind "user" und "container".

[in] dwFlags

Enthält eine Reihe von Flags, die den Typ des abzurufenden Symbols angeben. Dies kann eine Kombination aus mindestens einem der folgenden Werte sein.

DSGIF_ISNORMAL

Ruft das normale Symbol für die Objektklasse ab.

DSGIF_ISOPEN

Ruft das geöffnete Symbol, z. B. einen geöffneten Ordner, für die Objektklasse ab. Wenn die Objektklasse kein geöffnetes Symbol aufweist, versucht diese Methode, das normale Symbol für die Objektklasse abzurufen.

DSGIF_ISDISABLED

Ruft das deaktivierte Symbol, z. B. einen deaktivierten Benutzer, für die Objektklasse ab. Wenn die Objektklasse kein deaktiviertes Symbol aufweist, versucht diese Methode, das normale Symbol für die Objektklasse abzurufen.

DSGIF_ISMASK

Wird verwendet, um die DSGIF_ISNORMAL-, DSGIF_ISOPEN - und DSGIF_ISDISABLED-Flags zu maskieren.

DSGIF_GETDEFAULTICON

Wenn kein Symbol für die Objektklasse gefunden werden kann, gibt diese Methode ein Standardsymbol zurück. Wenn dieses Flag nicht angegeben ist und kein Symbol für die Objektklasse gefunden werden kann, gibt diese Methode NULL zurück.

DSGIF_DEFAULTISCONTAINER

Wenn kein Symbol für die Objektklasse gefunden werden kann, gibt diese Methode das Containersymbol als Standardsymbol zurück. Wenn dieses Flag nicht angegeben ist und kein Symbol für die Objektklasse gefunden werden kann, gibt diese Methode NULL zurück.

[in] cxIcon

Enthält die gewünschte Breite des Symbols in Pixel. Diese Methode ruft das Symbol ab, das dieser Breite am ehesten entspricht.

[in] cyIcon

Enthält die gewünschte Höhe des Symbols in Pixel. Diese Methode ruft das Symbol ab, das dieser Höhe am ehesten entspricht.

Rückgabewert

Gibt ein Handle für das Symbol zurück, falls erfolgreich, oder andernfalls NULL . Der Aufrufer muss dieses Symbol zerstören, wenn es nicht mehr benötigt wird, indem dieses Handle an DestroyIcon übergeben wird.

Anforderungen

Weitere Informationen

DestroyIcon

Anzeigen von Schnittstellen in Active Directory Domain Services

IDsDisplaySpecifier