Partilhar via

Método IVssAdmin::RegisterProvider (vsadmin.h)

O método RegisterProvider registra um novo provedor de cópia de sombra.

Sintaxe

HRESULT RegisterProvider(
  [in] VSS_ID            pProviderId,
  [in] CLSID             ClassId,
  [in] VSS_PWSZ          pwszProviderName,
  [in] VSS_PROVIDER_TYPE eProviderType,
  [in] VSS_PWSZ          pwszProviderVersion,
  [in] VSS_ID            ProviderVersionId
);

Parâmetros

[in] pProviderId

O VSS_ID que identifica exclusiva e persistentemente o provedor. Depois de definido, o parâmetro ProviderId deve permanecer o mesmo, mesmo quando a revisão de software for atualizada. Um parâmetro ProviderId só deve ser alterado quando a funcionalidade for alterada o suficiente para que ambos os provedores estejam ativos no mesmo sistema. Um solicitante pode usar o parâmetro ProviderId para solicitar que um provedor específico seja usado em uma criação de cópia de sombra.

[in] ClassId

O CLSID do provedor.

[in] pwszProviderName

O nome do provedor.

[in] eProviderType

Um valor de enumeração VSS_PROVIDER_TYPE que especifica o tipo de provedor. Observe que VSS_PROV_HARDWARE não é um tipo de provedor válido nas versões do sistema operacional cliente Windows. Os provedores de hardware serão executados somente em versões do sistema operacional Windows Server.

[in] pwszProviderVersion

A versão do provedor.

[in] ProviderVersionId

O VSS_ID que identifica exclusivamente essa versão do provedor. A combinação dos parâmetros pProviderId e ProviderVersionId deve ser exclusiva. O parâmetro ProviderVersionId pode ser o mesmo que o parâmetro ProviderVersionId de outro provedor.

Valor de retorno

Esse método pode retornar um desses valores.

Código de retorno Description
S_OK
 O provedor foi registrado com êxito.
E_INVALIDARG
 Um ou mais dos valores de parâmetro não são válidos. Por exemplo, VSS_PROV_HARDWARE não é um tipo de provedor válido nas versões do sistema operacional cliente Windows.
E_OUTOFMEMORY
 Memória insuficiente ou outros recursos do sistema.
E_ACCESSDENIED
 O chamador não é um administrador.
VSS_E_PROVIDER_ALREADY_REGISTERED
 O provedor já foi registrado neste computador.
VSS_E_UNEXPECTED
 Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte o tratamento de eventos e erros em VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado em vez disso.

Observações

Se o provedor de hardware for atualizado, o aplicativo de instalação deverá chamar o método UnregisterProvider para cancelar o registro da versão desatualizada e chamar o método RegisterProvider para registrar o provedor atualizado.

Nota Os provedores de hardware só podem ser registrados em sistemas operacionais windows server.
 

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header vsadmin.h

Consulte também

IVssAdmin

UnregisterProvider

  • Last updated on