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 VSS_PROVIDER_TYPE valor de enumeração que especifica o tipo de provedor. Observe que VSS_PROV_HARDWARE não é um tipo de provedor válido em 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.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
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 em versões do sistema operacional cliente Windows.
E_OUTOFMEMORY	Sem memória 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 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.

Comentários

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, em seguida, chamar o método RegisterProvider para registrar o provedor atualizado.

Nota Os provedores de hardware só podem ser registrados em sistemas operacionais Windows Server.

 

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vsadmin.h

Confira também

IVssAdmin

UnregisterProvider