Metoda ReadBackupHeader (SQLServer)
Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.
The ReadBackupHeadermethod returns a QueryResults object enumerating the contents of the media maintained by a backup device or operating system file.
Składnia
object
.ReadBackupHeader(
Restore
)
as
QueryResults
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.Przywracanie
Restore obiekt z zestawu, aby określić właściwości urządzenie kopia zapasowa lub plik i, opcjonalnie, zestaw kopii zapasowych.
Prototyp (C/C++)
HRESULT ReadBackupHeader(
LPSQLDMORESTORE Restore,
LPSQLDMOQUERYRESULTS* ppResults);
Zwraca
A QueryResults obiekt zawierający jeden zestaw wyników.Opis zestaw wyników zawartości, zobacz Metodę ReadBackupHeader (urządzenie kopii zapasowej).
Uwagi
Podczas korzystania z ReadBackupHeader metoda, jeden z przywrócić właściwości obiektu urządzenia musi wskazywać urządzenia lub pliku utrzymania kopia zapasowa media.
Aby użyć metoda ReadBackupHeader
Tworzenie SQLServer obiektu.
Połączenie SQLServer obiektu do wystąpienie Microsoft SQL Server, w którym źródło urządzenie kopia zapasowa jest widoczny.
Tworzenie Restore obiektu.
Ustawić Devices, Files, Pipes, lub Tapes właściwość oznacza urządzenie widoczne na wystąpienie programu SQL Server w kroku 2 i utrzymywanie nośnika kopia zapasowa.Należy określić tylko jednego urządzenia lub pliku.
W razie potrzeby ustaw FileNumber właściwość, aby wskazać konkretną zestaw kopii zapasowych przez porządkowa lokalizacji na nośniku.Domyślnie nagłówek pierwszej zestaw kopii zapasowych jest wyliczana na nośniku.
Call the ReadBackupHeader method of the SQLServerobject using the Restore object created in Step 3 as an argument.
SQL Server można udostępniać kopia zapasowa media innych narzędzi systemu operacyjnego, które wykonują kopia zapasowa innych danych i multimediów w urządzeniu mogą zawierać nagłówki utworzone przez innych narzędzi.
Gdy nośnik z urządzenie kopia zapasowa jest nieużywany, na przykład gdy urządzenia dyskowego jest pusta, ReadBackupHeader metoda się powiedzie, zwraca pusty QueryResults obiektu.