PRJ_START_DIRECTORY_ENUMERATION_CB Rückruffunktion (projectedfslib.h)

Artikel
03/04/2024

Informiert den Anbieter, dass eine Verzeichnisaufzählung gestartet wird.

Syntax

PRJ_START_DIRECTORY_ENUMERATION_CB PrjStartDirectoryEnumerationCb;

HRESULT PrjStartDirectoryEnumerationCb(
  [in] const PRJ_CALLBACK_DATA *callbackData,
  [in] const GUID *enumerationId
)
{...}

Parameter

[in] callbackData

Informationen zum Vorgang. Die folgenden callbackData-Member sind erforderlich, um diesen Rückruf zu implementieren:

FilePathName Gibt das Verzeichnis an, das aufgelistet werden soll.

VersionInfo Stellt Versionsinformationen für das verzeichnis bereit, das aufgelistet werden soll.

Der Anbieter kann nur während der Ausführung des Rückrufs auf diesen Puffer zugreifen. Wenn der Vorgang geschrieben werden soll und Daten aus diesem Puffer benötigt werden, muss er eine eigene Kopie davon erstellen.

[in] enumerationId

Ein Bezeichner für diese Enumerationssitzung.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Der Anbieter hat den Vorgang erfolgreich abgeschlossen.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Das verzeichnis, das aufgelistet werden soll, ist im Sicherungsspeicher des Anbieters nicht vorhanden.
HRESULT_FROM_WIN32(ERROR_IO_PENDING)	Der Anbieter möchte den Vorgang zu einem späteren Zeitpunkt abschließen.

Ein entsprechender HRESULT-Fehlercode, wenn der Anbieter den Vorgang ausschlägt.

Hinweise

ProjFS fordert eine Verzeichnisaufzählung vom Anbieter an, indem zuerst dieser Rückruf aufgerufen wird, dann ein oder mehrere PRJ_GET_DIRECTORY_ENUMERATION_CB Rückrufe und dann der PRJ_END_DIRECTORY_ENUMERATION_CB Rückruf. Da mehrere Enumerationen parallel am gleichen Speicherort auftreten können, verwendet ProjFS das EnumerationId-Argument , um die Rückrufaufrufe einer einzelnen Enumerationssitzung zuzuordnen. Dies bedeutet, dass ein bestimmter Satz von Aufrufen der Enumerationsrückrufe den gleichen Wert für enumerationId für dieselbe Sitzung verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	projectedfslib.h

Freigeben über