Share via

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

  • Artigo

Provisiona um determinado dispositivo de armazenamento ou compartilhamento de rede como um destino de backup do Histórico de Arquivos e o atribui como o destino de backup padrão para o usuário atual.

Observação

O IFhConfigMgr foi preterido e pode ser alterado ou indisponível em versões futuras.

Sintaxe

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

Parâmetros

[in] TargetUrl

Especifica o dispositivo de armazenamento ou o compartilhamento de rede a ser provisionado e atribuído como o padrão.

[in] TargetName

Especifica um nome amigável para o destino de backup especificado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT , como um dos valores definidos no arquivo de cabeçalho FhErrors.h.

Comentários

Para discos locais, o parâmetro TargetUrl contém a letra da unidade. Esse caminho deve terminar com uma barra invertida à direita (por exemplo, "X:\").

Para compartilhamentos de rede, o parâmetro TargetUrl contém o caminho completo do compartilhamento. Esse caminho deve terminar com uma barra invertida à direita (por exemplo, "\\myserver\myshare\").

É altamente recomendável que o dispositivo de armazenamento ou o compartilhamento de rede especificado pelo parâmetro TargetUrl seja validado primeiro usando o método IFhConfigMgr::ValidateTarget . Se ValidateTarget retornar um resultado de validação diferente de FH_VALID_TARGET, atribuir esse dispositivo de armazenamento ou compartilhamento de rede como o destino de backup padrão poderá ter consequências imprevisíveis.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho fhcfg.h

Confira também

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::ValidateTarget