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)

Weitere Informationen

Ibindctx

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

ITEMIDLIST

SHGetPathFromIDList