Freigeben über

_SHCONTF-Aufzählung (shobjidl_core.h)

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 ein, die keine Ordner in der Enumeration sind.
SHCONTF_INCLUDEHIDDEN
Wert: 0x80
0x00080. Schließen Sie ausgeblendete Elemente in die Enumeration ein. Dazu gehören keine ausgeblendeten Systemelemente. (Um ausgeblendete Systemelemente einzuschließen, verwenden Sie SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
Wert: 0x100
0x00100. Wird nicht mehr verwendet; immer angenommen. IShellFolder::EnumObjects kann zurückgegeben werden, ohne das Enumerationsobjekt zu überprüfen. Die Überprüfung kann bis zum ersten Aufruf von IEnumIDList::Next verschoben werden. Verwenden Sie dieses Kennzeichen, wenn eine Benutzeroberfläche möglicherweise vor dem ersten IEnumIDList::Next-Aufruf angezeigt wird. Damit eine Benutzeroberfläche angezeigt werden kann, 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 barrierefreien Speicher und ihren Vorgängern 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 Nicht-Systemelemente einzuschließen, verwenden Sie SHCONTF_INCLUDEHIDDEN.)

Bemerkungen

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. Initialisierung kann zurückgestellt werden, bis der Enumerationsprozess gestartet wird. Wenn die Initialisierung des Enumerationsobjekts ein langer Prozess ist, sollte die Methodenimplementierung sofort ein nicht initialisiertes Objekt zurückgeben. Verzögern Sie die Initialisierung bis zum ersten Mal, wenn die IEnumIDList::Next-Methode 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 dazu, was zu tun ist, wenn hwnd auf NULL festgelegt ist, finden Sie im IShellFolder::EnumObjects-Verweis .

Anmerkung Der Name dieser Enumeration wurde in windows Vista in _SHCONTF geändert. Früher wurde es "tagSHCONTF" genannt. Aus Gründen der Kompatibilität mit Legacycode wird der Name SHCONTF über eine typedef-Anweisung definiert, um ein Synonym für DWORD zu sein.
 

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server [nur Desktop-Apps]
Header shobjidl_core.h (include Shobjidl.h)
  • Last updated on