Metoda ReadBackupHeader (Przywracanie)
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(
Server
)
as
QueryResults
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.Serwer
SQLServer obiekt połączony do wystąpienie Microsoft SQL Server, na którym urządzenia lub pliku jest widoczny.
Prototyp (C/C++)
HRESULT ReadBackupHeader(
LPSQLDMOSERVER ServerObject,
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 Restore Właściwości obiektu urządzenia musi wskazywać urządzenia lub pliku utrzymania nośnika kopia zapasowa.
Aby użyć metoda ReadBackupHeader
Tworzenie SQLServer obiektu.
Połączenie SQLServer obiektu do wystąpienie programu 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 Restoreobject using the SQLServer object created in Step 1 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.