IDsDisplaySpecifier::GetIconLocation-Methode (dsclient.h)
Die IDsDisplaySpecifier::GetIconLocation-Methode ruft den Symbolspeicherort für eine bestimmte Objektklasse ab. Der Symbolspeicherort enthält den Dateinamen und den Ressourcenbezeichner.
Syntax
HRESULT GetIconLocation(
[in] LPCWSTR pszObjectClass,
[in] DWORD dwFlags,
[in, out] LPWSTR pszBuffer,
[in] INT cchBuffer,
[in, out] INT *presid
);
Parameter
[in] pszObjectClass
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der Objektklasse enthält, für die der Symbolspeicherort 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 einer der folgenden Elemente 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_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, out] pszBuffer
Zeiger auf einen Puffer mit breitem Zeichen, der den Pfad und den Dateinamen der Datei empfängt, die das Symbol enthält. Dieser Puffer muss mindestens cchBuffer breit sein.
[in] cchBuffer
Enthält die Größe des pszBuffer-Puffers in Breitzeichen, einschließlich des beendenden NULL-Zeichens . Wenn der Dateiname diese Anzahl von Zeichen überschreitet, wird der Dateiname abgeschnitten.
[in, out] presid
Zeiger auf einen INT-Wert , der den Ressourcenbezeichner oder Index des Symbols empfängt. Wenn dieser Wert positiv ist, ist der Wert der Index des Symbols in der Datei. Wenn dieser Wert negativ ist, ist der absolute Wert dieses Werts der Ressourcenbezeichner des Symbols in der Datei.
Rückgabewert
Gibt einen HRESULT-Standardwert zurück, der Folgendes enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | dsclient.h |
| DLL | Dsadmin.dll |
Weitere Informationen
Anzeigen von Schnittstellen in Active Directory Domain Services