SHParseDisplayName-Funktion (shlobj_core.h)
Übersetzt den Anzeigenamen eines Shell-Namespaceobjekts in eine Elementbezeichnerliste und gibt die Attribute des Objekts zurück. Diese Funktion ist die bevorzugte Methode zum Konvertieren einer Zeichenfolge in einen Zeiger auf eine Elementbezeichnerliste (Item Identifier List, PIDL).
Syntax
SHSTDAPI SHParseDisplayName(
[in] PCWSTR pszName,
[in, optional] IBindCtx *pbc,
[out] PIDLIST_ABSOLUTE *ppidl,
[in] SFGAOF sfgaoIn,
[out, optional] SFGAOF *psfgaoOut
);
Parameter
[in] pszName
Typ: LPCWSTR
Ein Zeiger auf eine mit Null beendete breite Zeichenfolge, die den zu analysierenden Anzeigenamen enthält.
[in, optional] pbc
Typ: IBindCtx*
Ein Bindungskontext, der den Analysevorgang steuert. Dieser Parameter ist normalerweise auf NULL festgelegt.
[out] ppidl
Typ: PIDLIST_ABSOLUTE*
Die Adresse eines Zeigers auf eine Variable vom Typ ITEMIDLIST , die die Elementbezeichnerliste für das Objekt empfängt. Wenn ein Fehler auftritt, wird dieser Parameter auf NULL festgelegt.
[in] sfgaoIn
Typ: SFGAOF
Ein ULONG-Wert , der die abzufragenden Attribute angibt. Um ein oder mehrere Attribute abzufragen, initialisieren Sie diesen Parameter mit den Flags, die die relevanten Attribute darstellen. Eine Liste der verfügbaren SFGAO-Flags finden Sie unter SFGAO.
[out, optional] psfgaoOut
Typ: SFGAOF*
Ein Zeiger auf eine ULONG. Bei der Rückgabe werden die Attribute festgelegt, die für das Objekt true sind und in sfgaoIn angefordert wurden. Die Attributflags eines Objekts können null oder eine Kombination aus SFGAO-Flags sein. Eine Liste der verfügbaren SFGAO-Flags finden Sie unter SFGAO.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie sollten diese Funktion über einen Hintergrundthread aufrufen. Andernfalls reagiert die Benutzeroberfläche nicht mehr.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h (einschließlich Shlobj.h) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 6.0 oder höher) |