IFhConfigMgr::P rovisionAndSetNewTarget-Methode (fhcfg.h)
Stellt ein bestimmtes Speichergerät oder eine Netzwerkfreigabe als Sicherungsziel für den Dateiverlauf bereit und weist es als Standardsicherungsziel für den aktuellen Benutzer zu.
Hinweis
IFhConfigMgr ist veraltet und kann in zukünftigen Releases geändert oder nicht mehr verfügbar sein.
Syntax
HRESULT ProvisionAndSetNewTarget(
[in] BSTR TargetUrl,
[in] BSTR TargetName
);
Parameter
[in] TargetUrl
Gibt das Speichergerät oder die Netzwerkfreigabe an, die bereitgestellt und als Standard zugewiesen werden soll.
[in] TargetName
Gibt einen benutzerfreundlichen Namen für das angegebene Sicherungsziel an.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben, z. B. einer der in der Headerdatei FhErrors.h definierten Werte.
Hinweise
Bei lokalen Datenträgern enthält der TargetUrl-Parameter den Laufwerkbuchstaben. Dieser Pfad muss mit einem nachfolgenden umgekehrten Schrägstrich enden (z. B. "X:\").
Für Netzwerkfreigaben enthält der TargetUrl-Parameter den vollständigen Pfad der Freigabe. Dieser Pfad muss mit einem nachfolgenden umgekehrten Schrägstrich enden (z. B. "\\myserver\myshare\").
Es wird dringend empfohlen, das durch den TargetUrl-Parameter angegebene Speichergerät oder netzwerkfreigabe zuerst mithilfe der IFhConfigMgr::ValidateTarget-Methode zu überprüfen. Wenn ValidateTarget ein anderes Validierungsergebnis als FH_VALID_TARGET zurückgibt, kann die Zuweisung dieses Speichergeräts oder der Netzwerkfreigabe als Standardsicherungsziel unvorhersehbare Folgen haben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fhcfg.h |