IVssSoftwareSnapshotProvider::GetSnapshotProperties-Methode (vsprov.h)
Ruft die Eigenschaften der angegebenen Schattenkopie ab.
Syntax
HRESULT GetSnapshotProperties(
[in] VSS_ID SnapshotId,
[out] VSS_SNAPSHOT_PROP *pProp
);
Parameter
[in] SnapshotId
Bezeichner für Schattenkopien.
[out] pProp
Die Adresse einer vom Aufrufer zugewiesenen VSS_SNAPSHOT_PROP Struktur, die die Schattenkopieeigenschaften empfängt. Der Anbieter ist für das Festlegen der Member dieser Struktur verantwortlich. Alle Member sind erforderlich, außer m_pwszExposedName und m_pwszExposedPath, die der Anbieter auf NULL festlegen kann. Der Anbieter weist arbeitsspeicher für alle Zeichenfolgenmember zu, die er in der Struktur festlegt. Wenn die Struktur nicht mehr benötigt wird, ist der Aufrufer für das Freigeben dieser Zeichenfolgen verantwortlich, indem er die VssFreeSnapshotProperties-Funktion aufruft .
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Die angeforderten Informationen wurden erfolgreich zurückgegeben. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das angegebene Volume wurde nicht gefunden. |
|
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. |
Hinweise
Der Aufrufer sollte den Inhalt der VSS_SNAPSHOT_PROP-Struktur auf Null festlegen, bevor die GetSnapshotProperties-Methode aufgerufen wird .
Der Anbieter ist für die Zuordnung und Freigabe der Zeichenfolgen in der VSS_SNAPSHOT_PROP-Struktur verantwortlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsprov.h |
| Bibliothek | VssApi.lib |