INameSpaceTreeControlFolderCapabilities::GetFolderCapabilities-Methode (shobjidl_core.h)

  • Artikel

Ruft die Funktion eines Ordners ab, um über den System.IsPinnedToNameSpaceTree-Eigenschaftsschlüsselwert gefiltert zu werden, und ändert die Benachrichtigungsregistrierung status.

Syntax

HRESULT GetFolderCapabilities(
  [in]  NSTCFOLDERCAPABILITIES nfcMask,
  [out] NSTCFOLDERCAPABILITIES *pnfcValue
);

Parameter

[in] nfcMask

Typ: NSTCFOLDERCAPABILITIES

Die Funktionen, für die diese Methode Werte abrufen soll. Geben Sie eine oder beide der folgenden Optionen an:

NSTCFC_PINNEDITEMFILTERING (0x00000001)

0x00000001. Die System.IsPinnedToNameSpaceTree-Eigenschaft ist in diesem Ordner vorhanden, und die Filterung basierend auf diesem Eigenschaftswert wird unterstützt.

NSTCFC_DELAY_REGISTER_NOTIFY (0x00000002)

0x00000002. Die Registrierung für Änderungsbenachrichtigungen wird verzögert, bis der Ordner im Navigationsbereich erweitert wird.

[out] pnfcValue

Typ: NSTCFOLDERCAPABILITIES*

Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode die in nfcMask angeforderten Funktionen empfängt. Mit Ausnahme von NSTCFC_NONE spiegeln Bitwerte in Positionen, die in nfcMask nicht ausdrücklich angefordert werden, nicht unbedingt die Funktionen wider und sollten nicht verwendet werden.

NSTCFC_NONE (0x00000000)

0x00000000. Die System.IsPinnedToNameSpaceTree-Eigenschaft ist in diesem Ordner nicht vorhanden. Filterung wird nicht unterstützt.

NSTCFC_PINNEDITEMFILTERING (0x00000001)

0x00000001. Die System.IsPinnedToNameSpaceTree-Eigenschaft ist in diesem Ordner vorhanden, und die Filterung basierend auf diesem Eigenschaftswert wird unterstützt.

NSTCFC_DELAY_REGISTER_NOTIFY (0x00000002)

0x00000002. Die Registrierung für Änderungsbenachrichtigungen wird verzögert, bis der Ordner im Navigationsbereich erweitert wird.

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 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)