IVssFileShareSnapshotProvider::GetSnapshotProperties-Methode (vsprov.h)
Ruft die VSS_SNAPSHOT_PROP-Struktur für eine Dateifreigabe Momentaufnahme 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. |
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.
Der VSS-Koordinator ruft diese Methode während der PostSnapshot-Phase der Erstellung Momentaufnahme auf, um den Momentaufnahme-Zugriffspfad (UNC-Pfad für Dateifreigabemomentaufnahmen) abzurufen. Der Koordinator ruft diese Methode nach PreFinalCommitSnapshots und vor dem Aufrufen von PostSnapshot in den Writern auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsprov.h |
| Bibliothek | VssApi.lib |