JET_PFNSTATUS Rückruffunktion

Gilt für: Windows | Windows Server

JET_PFNSTATUS Rückruffunktion

Die rückruffunktion JET_PFNSTATUS empfängt Informationen über den Fortschritt von Vorgängen mit langer Ausführungsdauer, z. B. Defragmentierung, Sicherung oder Wiederherstellungsvorgänge. Während solcher Vorgänge ruft die Datenbank-Engine diese Rückruffunktion auf, um den Fortschritt des Vorgangs zu aktualisieren.

    JET_ERR JET_API JET_PFNSTATUS(
                           JET_SESID  sesid,
                           JET_SNP snp,
                           JET_SNT snt,
                           void* pv
    );

Parameter

sesid

Die Sitzung vom Typ JET_SESID , mit der die Funktion mit langer Ausführungszeit aufgerufen wurde.

Snp

Der in JET_SNP angegebene Vorgangstyp. Zu den Arten von Vorgängen gehören Reparatur, Komprimieren, Wiederherstellen, Sichern, Aktualisieren, Bereinbern und Aktualisieren des Datensatzformats.

Snt

Die status eines Vorgangs. Statustypen sind Anfang, In Bearbeitung, Abschluss oder Fehler. Die status wird mit dem dritten Parameter vom Typ JET_SNT angegeben.

pv

Ein optionaler Zeiger auf eine Struktur vom Typ JET_SNPROG.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der Fehlercodes der Erweiterbaren Speicher-Engine zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Bei Erfolg kann der Vorgang, der den Rückruf ausgegeben hat, normal fortgesetzt werden. In einigen Fällen gibt der Rückruf möglicherweise eine Warnung zurück, die diesen Vorgang beeinflusst.

Bei einem Fehler wird der Vorgang, der den Rückruf ausgegeben hat, möglicherweise normal fortgesetzt oder schlägt fehl.

Bemerkungen

Diese Rückruffunktion wird in einer Statusbenachrichtigung verwendet, in der die Struktur den aktuellen Status des Fortschritts angibt. Beachten Sie, dass die Rückruffunktion für den Fortschritt des Vorgangs möglicherweise mehrmals aufgerufen wird.

Anforderungen

Weitere Informationen

Fehlercodes der erweiterbaren Speicher-Engine
Fehler der erweiterbaren Speicher-Engine
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT