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

  • Artículo

Aprovisiona un determinado dispositivo de almacenamiento o un recurso compartido de red como destino de copia de seguridad del historial de archivos y lo asigna como destino de copia de seguridad predeterminado para el usuario actual.

Nota:

IFhConfigMgr está en desuso y puede modificarse o no estar disponible en futuras versiones.

Sintaxis

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

Parámetros

[in] TargetUrl

Especifica el dispositivo de almacenamiento o el recurso compartido de red que se va a aprovisionar y asignar como valor predeterminado.

[in] TargetName

Especifica un nombre descriptivo para el destino de copia de seguridad especificado.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT , como uno de los valores definidos en el archivo de encabezado FhErrors.h.

Comentarios

En el caso de los discos locales, el parámetro TargetUrl contiene la letra de unidad. Esta ruta de acceso debe terminar con una barra diagonal inversa final (por ejemplo, "X:\").

Para los recursos compartidos de red, el parámetro TargetUrl contiene la ruta de acceso completa del recurso compartido. Esta ruta de acceso debe terminar con una barra diagonal inversa final (por ejemplo, "\\myserver\myshare\").

Se recomienda encarecidamente validar primero el dispositivo de almacenamiento o el recurso compartido de red especificado por el parámetro TargetUrl mediante el método IFhConfigMgr::ValidateTarget . Si ValidateTarget devuelve un resultado de validación distinto de FH_VALID_TARGET, asignar este recurso compartido de red o dispositivo de almacenamiento, ya que el destino de copia de seguridad predeterminado puede tener consecuencias impredecibles.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fhcfg.h

Consulte también

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::ValidateTarget