CSCFindFirstFileW-Funktion

Artikel
06/13/2023

[Diese Funktion wird nicht unterstützt und sollte nicht verwendet werden.]

Sucht im Offlinedateiencache nach einer Datei, die die angegebenen Kriterien erfüllt.

Syntax

HANDLE WINAPI CSCFindFirstFileW(
  _In_  LPCWSTR          lpszFileName,
  _Out_ WIN32_FIND_DATAW *lpFind32,
  _Out_ LPDWORD          lpdwStatus,
  _Out_ LPDWORD          lpdwPinCount,
  _Out_ LPDWORD          lpdwHintFlags,
  _Out_ FILETIME         *lpOrgFileTime
);

Parameter

lpszFileName [in]

Ein Zeiger auf eine NULL-Zeichenfolge, die ein gültiges UNC-Verzeichnis oder einen gültigen UNC-Pfad angibt.

lpFind32 [out]

Ein Zeiger auf die WIN32_FIND_DATA-Struktur , die Informationen über die Datei oder das Unterverzeichnis empfängt.

lpdwStatus [out]

Ein NTSTATUS-Code, der die status des Aufrufs angibt.

lpdwPinCount [out]

Dieser Parameter ist nichtzero, wenn die Datei offline verfügbar gemacht wurde, oder andernfalls 0.

lpdwHintFlags [out]

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
FLAG_CSC_HINT_PIN_USER 0x01	Ein Benutzer hat die Datei offline verfügbar gemacht.
FLAG_CSC_HINT_PIN_INHERIT_USER 0x02	Ein Benutzer hat das übergeordnete Element offline verfügbar gemacht und das übergeordnete Element so markiert, dass die untergeordneten Elemente offline verfügbar sind.
FLAG_CSC_HINT_PIN_INHERIT_SYSTEM 0x04	Eine Administrator- oder Gruppenrichtlinie hat das übergeordnete Element offline verfügbar gemacht und das übergeordnete Element so markiert, dass die untergeordneten Elemente offline verfügbar sind.
FLAG_CSC_HINT_PIN_SYSTEM 0x10	Eine Administrator- oder Gruppenrichtlinie hat die Datei offline verfügbar gemacht.

lpOrgFileTime [out]

Ein Zeiger auf eine FILETIME-Struktur zum Empfangen der Datums- und Uhrzeitinformationen für die Datei oder das Unterverzeichnis.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf von CSCFindNextFileW oder CSCFindClose verwendet wird.

Wenn die Funktion fehlschlägt, ist der Rückgabewert INVALID_HANDLE_VALUE.

Bemerkungen

Diese Funktion verfügt über keine zugeordnete Importbibliothek oder Headerdatei. Sie müssen es mit den Funktionen LoadLibrary und GetProcAddress aufrufen.

Anforderungen

Anforderung	Wert
DLL	Cscmig.dll

Freigeben über