_SHCONTF-Enumeration (shobjidl_core.h)

  • Artikel

Bestimmt die Typen von Elementen, die in einer Enumeration enthalten sind. Diese Werte werden mit der IShellFolder::EnumObjects-Methode verwendet.

Syntax

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

Konstanten

 
SHCONTF_CHECKING_FOR_CHILDREN
Wert: 0x10
0x00010. Windows 7 und höher. Die aufrufende Anwendung überprüft, ob untergeordnete Elemente im Ordner vorhanden sind.
SHCONTF_FOLDERS
Wert: 0x20
0x00020. Schließen Sie Elemente ein, die Ordner in der Enumeration sind.
SHCONTF_NONFOLDERS
Wert: 0x40
0x00040. Schließen Sie Elemente, die keine Ordner sind, in die Enumeration ein.
SHCONTF_INCLUDEHIDDEN
Wert: 0x80
0x00080. Schließen Sie ausgeblendete Elemente in die Enumeration ein. Dies schließt keine ausgeblendeten Systemelemente ein. (Um ausgeblendete Systemelemente einzuschließen, verwenden Sie SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
Wert: 0x100
0x00100. Nicht mehr verwendet; immer angenommen. IShellFolder::EnumObjects kann zurückgeben, ohne das Enumerationsobjekt zu überprüfen. Die Validierung kann bis zum ersten Aufruf von IEnumIDList::Next verschoben werden. Verwenden Sie dieses Flag, wenn vor dem ersten IEnumIDList::Next-Aufruf möglicherweise eine Benutzeroberfläche angezeigt wird. Damit eine Benutzeroberfläche angezeigt wird, muss hwnd auf ein gültiges Fensterhandle festgelegt werden.
SHCONTF_NETPRINTERSRCH
Wert: 0x200
0x00200. Die aufrufende Anwendung sucht nach Druckerobjekten.
SHCONTF_SHAREABLE
Wert: 0x400
0x00400. Die aufrufende Anwendung sucht nach Ressourcen, die freigegeben werden können.
SHCONTF_STORAGE
Wert: 0x800
0x00800. Schließen Sie Elemente mit barrierefreiem Speicher und deren Vorgänger ein, einschließlich ausgeblendeter Elemente.
SHCONTF_NAVIGATION_ENUM
Wert: 0x1000
0x01000. Windows 7 und höher. Untergeordnete Ordner sollten eine Navigationsaufzählung bereitstellen.
SHCONTF_FASTITEMS
Wert: 0x2000
0x02000. Windows Vista und höher. Die aufrufende Anwendung sucht nach Ressourcen, die schnell aufgezählt werden können.
SHCONTF_FLATLIST
Wert: 0x4000
0x04000. Windows Vista und höher. Veraltet. Nicht verwenden.
SHCONTF_ENABLE_ASYNC
Wert: 0x8000
0x08000. Windows Vista und höher. Die aufrufende Anwendung überwacht Änderungsbenachrichtigungen. Dies bedeutet, dass der Enumerator nicht alle Ergebnisse zurückgeben muss. Elemente können über Änderungsbenachrichtigungen gemeldet werden.
SHCONTF_INCLUDESUPERHIDDEN
Wert: 0x10000
0x10000. Windows 7 und höher. Schließen Sie ausgeblendete Systemelemente in die Enumeration ein. Dieser Wert enthält keine ausgeblendeten Nicht-Systemelemente. (Um ausgeblendete Nichtsystemelemente einzuschließen, verwenden Sie SHCONTF_INCLUDEHIDDEN.)

Hinweise

Durch Festlegen des SHCONTF_INIT_ON_FIRST_NEXT-Flags schlägt die aufrufende Anwendung vor, dass die IShellFolder::EnumObjects-Methode den Enumerationsprozess beschleunigen kann, indem ein nicht initialisiertes Enumerationsobjekt zurückgegeben wird. Die Initialisierung kann zurückgestellt werden, bis der Enumerationsprozess gestartet wird. Wenn die Initialisierung des Enumerationsobjekts langwierig ist, sollte die Methodenimplementierung sofort ein nicht initialisiertes Objekt zurückgeben. Verzögern Sie die Initialisierung, bis die IEnumIDList::Next-Methode zum ersten Mal aufgerufen wird. Wenn für die Initialisierung Benutzereingaben erforderlich sind, sollte die Methodenimplementierung hwnd als übergeordnetes Fenster für die Benutzeroberfläche verwenden. Eine Erläuterung, was zu tun ist, wenn hwnd auf NULL festgelegt ist, finden Sie in der IShellFolder::EnumObjects-Referenz .

Hinweis Der Name dieser Enumeration wurde in Windows Vista in _SHCONTF geändert. Zuvor wurde sie tagSHCONTF genannt. Aus Gründen der Kompatibilität mit Legacycode wird der Name SHCONTF über eine typedef-Anweisung als Synonym für DWORD definiert.
 

Anforderungen

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