Freigeben über

FSCTL_SUSPEND_OVERLAY Steuerelementcode

Der FSCTL_SUSPEND_OVERLAY-Steuerelementcode hält eine an ein Volume angefügte Sicherungsquelle an und verhindert den Zugriff auf die Sicherungsquelle und lässt zu, dass sie geändert oder entfernt werden kann.

Rufen Sie zum Ausführen dieses Vorgangs 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

Die Parameter

  • Instanz [in]: Nur FltFsControlFile . Ein undurchsichtiger Instanzzeiger 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 die Überlagerung aktualisiert wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.

  • FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie FSCTL_SUSPEND_OVERLAY für diesen Vorgang.

  • 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 einbezogen. Wenn der Anbieter eine WIM-Datei ist, wird nach WOF_EXTERNAL_INFO eine WIM_PROVIDER_SUSPEND_OVERLAY_INPUT Struktur eingeschlossen.

  • InputBufferLength [in]: Set to sizeof(WOF_EXTERNAL_INFO) plus the size of any additional provider input data.

  • OutputBuffer [out]: Nicht verwendet. Auf NULL festgelegt.

  • OutputBufferLength [in]: Auf 0 festlegen.

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.

Programmcode Bedeutung
STATUS_ACCESS_DENIED Der Antragsteller 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_INTERNE_FEHLER Auf das angeforderte Volume kann nicht zugegriffen werden.
STATUS_INVALID_DEVICE_REQUEST Der Sicherungsdienst ist nicht vorhanden oder nicht gestartet.

Bemerkungen

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. Der InputBufferLength in diesem Fall ist 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 Sicherungsanbieter definieren ihre eigenen spezifischen Eingabeparameterstrukturen.

Anforderungen

Anforderungstyp Anforderung
Kopfzeile Ntifs.h (enthalten Ntifs.h oder Fltkernel.h)

Siehe auch

FSCTL_REMOVE_OVERLAY

FSCTL_UPDATE_OVERLAY

FSCTL_GET_EXTERNAL_BACKING

FSCTL_SET_EXTERNAL_BACKING

  • Last updated on