INameSpaceTreeControl::AppendRoot-Methode (shobjidl_core.h)

Artikel
03/02/2024

Fügt ein Shellelement an die Liste der Wurzeln in einer Struktur an.

Syntax

HRESULT AppendRoot(
  [in] IShellItem       *psiRoot,
  [in] SHCONTF          grfEnumFlags,
  [in] NSTCROOTSTYLE    grfRootStyle,
  [in] IShellItemFilter *pif
);

Parameter

[in] psiRoot

Typ: IShellItem*

Zeiger auf das shell-Element, das angefügt wird.

[in] grfEnumFlags

Typ: SHCONTF

Listet die Eigenschaften der Wurzel und all ihrer Kinder auf. Mindestens einer der Werte vom Typ SHCONTF. Diese Flags können mithilfe eines bitweisen OR kombiniert werden.

[in] grfRootStyle

Typ: NSTCROOTSTYLE

Gibt den Stil des Stamms an, der angefügt wird. Mindestens einer der folgenden Werte:

NSTCRS_VISIBLE (0x0000)

Sowohl der Stamm als auch die Elemente sind sichtbar. Schließen Sie sich mit NSTCRS_HIDDEN gegenseitig aus.

NSTCRS_HIDDEN (0x0001)

Der Stamm ist ausgeblendet, sodass nur die untergeordneten Elemente sichtbar sind. Schließen Sie sich mit NSTCRS_VISIBLE gegenseitig aus.

NSTCRS_EXPANDED (0x0002)

Der Stamm wird bei der Initialisierung erweitert.

[in] pif

Typ: IShellItemFilter*

Zeiger auf den IShellItemFilter , mit dem Sie filtern können, welche Elemente in der Struktur angezeigt werden. Wenn angegeben, kann jedes Element mit einem SHCONTF-Flag angepasst werden. Dieser Wert kann NULL sein, wenn kein Filter erforderlich ist.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über