Méthode IFhConfigMgr::P rovisionAndSetNewTarget (fhcfg.h)

Approvisionne un périphérique de stockage ou un partage réseau en tant que cible de sauvegarde de l’historique des fichiers et l’affecte en tant que cible de sauvegarde par défaut pour l’utilisateur actuel.

Syntaxe

HRESULT ProvisionAndSetNewTarget(
  [in] BSTR TargetUrl,
  [in] BSTR TargetName
);

Paramètres

[in] TargetUrl

Spécifie le périphérique de stockage ou le partage réseau à provisionner et à affecter comme valeur par défaut.

[in] TargetName

Spécifie un nom convivial pour la cible de sauvegarde spécifiée.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT tel que l’une des valeurs définies dans le fichier d’en-tête FhErrors.h.

Notes

Pour les disques locaux, le paramètre TargetUrl contient la lettre de lecteur. Ce chemin doit se terminer par une barre oblique inverse (par exemple, « X:\ »).

Pour les partages réseau, le paramètre TargetUrl contient le chemin d’accès complet du partage. Ce chemin doit se terminer par une barre oblique inverse de fin (par exemple, « \\myserver\myshare\ »).

Il est vivement recommandé de valider d’abord le périphérique de stockage ou le partage réseau spécifié par le paramètre TargetUrl à l’aide de la méthode IFhConfigMgr::ValidateTarget . Si ValidateTarget retourne un résultat de validation autre que FH_VALID_TARGET, l’affectation de ce périphérique de stockage ou partage réseau comme cible de sauvegarde par défaut peut avoir des conséquences imprévisibles.

Spécifications

Voir aussi

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::ValidateTarget