Método IVssComponentEx::GetRestoreName (vswriter.h)
Obtém o nome lógico atribuído a um componente que está sendo restaurado.
Sintaxe
HRESULT GetRestoreName(
[out] BSTR *pbstrName
);
Parâmetros
[out] pbstrName
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres largos terminada em nulo que contém o nome da restauração do componente.
Retornar valor
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
A operação foi bem-sucedida. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
Comentários
O método GetRestoreName só pode ser chamado durante uma operação de restauração.
Se a chamada para GetRestoreName for bem-sucedida, o chamador será responsável por liberar a cadeia de caracteres retornada no parâmetro pbstrName chamando a função SysFreeString .
Um gravador indica que ele dá suporte a esse método definindo o sinalizador VSS_BS_RESTORE_RENAME em sua máscara de esquema de backup.
Para obter mais informações, consulte Definindo opções de restauração do VSS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |