FSCTL_SUSPEND_OVERLAY Steuerungscode

Artikel
02/07/2024

Der FSCTL_SUSPEND_OVERLAY-Steuerungscode hält eine an ein Volume angefügte Sicherungsquelle an, verhindert den Zugriff auf die Sicherungsquelle und ermöglicht es, sie zu ändern oder zu entfernen.

Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        FSCTL_SUSPEND_OVERLAY, // dwIoControlCode
                    (LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                    (LPDWORD)      lpOutBuffer,     // output buffer
                    (DWORD)        nOutBufferSize,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Parameter

Instanz [in]: Nur FltFsControlFile . Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileObject [in]: Nur FltFsControlFile . Das Dateizeigerobjekt des Volumes, für das die Überlagerung aktualisiert wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: nur ZwFsControlFile . Das Handle des Volumes, für das das Overlay aktualisiert wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_SUSPEND_OVERLAY .
InputBuffer [in]: Ein Zeiger auf den Eingabepuffer, der eine WOF_EXTERNAL_INFO Struktur enthalten muss. Bei Bedarf werden unmittelbar nach WOF_EXTERNAL_INFO zusätzliche anbieterspezifische Daten eingeschlossen. Wenn es sich bei dem Anbieter um eine WIM-Datei handelt, wird nach WOF_EXTERNAL_INFO eine WIM_PROVIDER_SUSPEND_OVERLAY_INPUT-Struktur eingeschlossen.
InputBufferLength [in]: Legen Sie auf sizeof(WOF_EXTERNAL_INFO) plus die Größe aller zusätzlichen Anbietereingabedaten fest.
OutputBuffer [out]: Nicht verwendet. Auf NULL festgelegt.
OutputBufferLength [in]: Auf 0 festgelegt.

Statusblock

FltFsControlFile oder ZwFsControlFile gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die entsprechende Funktion möglicherweise einen der folgenden NTSTATUS-Werte zurück.

Code	Bedeutung
STATUS_ACCESS_DENIED	Der Anforderer verfügt nicht über Administratorrechte.
STATUS_BUFFER_TOO_SMALL	Die Länge des Eingabepuffers, auf den inputBuffer verweist und von InputBufferLength angegeben wird, ist zu klein.
STATUS_INTERNAL_ERROR	Auf das angeforderte Volume kann nicht zugegriffen werden.
STATUS_INVALID_DEVICE_REQUEST	Der Unterstützungsdienst ist nicht vorhanden oder nicht gestartet.

Hinweise

Wenn die zu entfernende Sicherungsquelle eine WIM-Datei (Windows Imaging Format) ist, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer WIM_PROVIDER_SUSPEND_OVERLAY_INPUT-Struktur . Die InputBufferLength lautet in diesem Fall sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). Der DataSourceId-Wert in WIM_PROVIDER_SUSPEND_OVERLAY_INPUT muss für eine WIM-Datei sein, die zuvor in einer FSCTL_ADD_OVERLAY-Anforderung hinzugefügt wurde.

Zusätzliche Unterstützungsanbieter definieren ihre eigenen spezifischen Eingabeparameterstrukturen.