Método IFhConfigMgr::P rovisionAndSetNewTarget (fhcfg.h)
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 |