IVssBackupComponents::Query-Methode (vsbackup.h)
Die Abfragemethode fragt Anbieter auf dem System und/oder die abgeschlossenen Schattenkopien im System ab, die sich im aktuellen Kontext befinden. Die Methode kann nur während Sicherungsvorgängen aufgerufen werden.
Syntax
HRESULT Query(
[in] VSS_ID QueriedObjectId,
[in] VSS_OBJECT_TYPE eQueriedObjectType,
[in] VSS_OBJECT_TYPE eReturnedObjectsType,
[out] IVssEnumObject **ppEnum
);
Parameter
[in] QueriedObjectId
Reserviert. Der Wert dieses Parameters muss GUID_NULL sein.
[in] eQueriedObjectType
Gibt die Einschränkung der Abfrage auf den angegebenen Objekttyp an. Ein Wert von VSS_OBJECT_NONE gibt keine Einschränkung an, d. h. alle Objekte werden abgefragt.
Derzeit muss der Wert dieses Parameters VSS_OBJECT_NONE sein.
[in] eReturnedObjectsType
Zurückzugebende Objekttypen. Der Wert dieses Parameters muss entweder VSS_OBJECT_SNAPSHOT oder VSS_OBJECT_PROVIDER sein.
[out] ppEnum
Doppelt indirekter Zeiger auf ein IVssEnumObject-Enumeratorobjekt .
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Es wurde erfolgreich ein Zeiger auf eine instance der IVssEnumObject-Schnittstelle zurückgegeben. |
|
Der Aufrufer ist kein Administrator oder Sicherungsoperator. |
|
Einer der Parameterwerte ist ungültig. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
Das abgefragte Objekt wurde nicht gefunden. |
|
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
|
Unerwarteter Anbieterfehler. Der Fehlercode wird im Fehlerprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
Hinweise
Da Query nur Informationen zu abgeschlossenen Schattenkopien zurückgibt, ist der einzige Schattenkopienzustand, den sie offenlegen kann, VSS_SS_COMPLETED.
Die Methode kann nur während Sicherungsvorgängen aufgerufen werden und muss durch Aufrufe von IVssBackupComponents::InitializeForBackup und IVssBackupComponents::SetContext vorangestellt werden.
Während Query Informationen zu allen auf einem System verfügbaren Anbietern zurückgeben kann, werden nur Informationen zu Schattenkopien mit dem aktuellen Kontext zurückgegeben (festgelegt durch IVssBackupComponents::SetContext). Wenn der _VSS_SNAPSHOT_CONTEXT Kontext für instance auf VSS_CTX_BACKUP festgelegt ist, gibt Query keine Informationen zu einer Schattenkopie zurück, die mit einem Kontext von VSS_CTX_FILE_SHARE_BACKUP erstellt wurde.
Während diese Methode derzeit eine Liste aller verfügbaren Anbieter und/oder aller abgeschlossenen Schattenkopien zurückgibt, werden in Zukunft möglicherweise spezialisierte Abfragen unterstützt: für instance, abfragen alle Schattenkopien, die einem Anbieter zugeordnet sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::InitializeForBackup