SfcGetNextProtectedFile-Funktion (sfc.h)

[Diese Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diese Funktion wurde in Windows Vista und Windows Server 2008 entfernt. Verwenden Sie stattdessen die unterstützten Funktionen, die in WRP-Funktionen aufgeführt sind.]

Ruft die vollständige Liste der geschützten Dateien ab. Anwendungen sollten diese Dateien nicht ersetzen.

Syntax

BOOL SfcGetNextProtectedFile(
  [in]      HANDLE               RpcHandle,
  [in, out] PPROTECTED_FILE_DATA ProtFileData
);

Parameter

[in] RpcHandle

Dieser Parameter muss NULL sein.

[in, out] ProtFileData

Die Liste der geschützten Dateien. Das Format dieser Struktur lautet wie folgt.

typedef struct _PROTECTED_FILE_DATA {
    WCHAR   FileName[MAX_PATH];
    DWORD   FileNumber;
} PROTECTED_FILE_DATA, *PPROTECTED_FILE_DATA;

Bevor Sie diese Funktion zum ersten Mal aufrufen, legen Sie das FileNumber-Element auf 0 (null) fest.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn keine geschützten Dateien mehr aufgelistet werden müssen, ist der Rückgabewert null, und GetLastError gibt ERROR_NO_MORE_FILES zurück. Wenn die Funktion fehlschlägt, gibt GetLastError einen anderen Fehlercode zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sfc.h
Bibliothek	Sfc.lib
DLL	Sfc.dll

Weitere Informationen

SfcIsFileProtected