Compartir a través de

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

  • Artículo

El método RegisterProvider registra un nuevo proveedor de instantáneas.

Sintaxis

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

El VSS_ID que identifica de forma única y persistente el proveedor. Una vez definido, el parámetro ProviderId debe permanecer igual, incluso cuando se actualiza la revisión de software. Solo se debe cambiar un parámetro ProviderId cuando la funcionalidad cambie lo suficiente para que ambos proveedores estén activos en el mismo sistema. Un solicitante puede usar el parámetro ProviderId para solicitar que se use un proveedor específico en una creación de instantáneas.

[in] ClassId

CLSID del proveedor.

[in] pwszProviderName

Nombre del proveedor.

[in] eProviderType

Valor de enumeración VSS_PROVIDER_TYPE que especifica el tipo de proveedor. Tenga en cuenta que VSS_PROV_HARDWARE no es un tipo de proveedor válido en las versiones del sistema operativo cliente Windows. Los proveedores de hardware solo se ejecutarán en versiones del sistema operativo Windows Server.

[in] pwszProviderVersion

Versión del proveedor.

[in] ProviderVersionId

El VSS_ID que identifica de forma única esta versión del proveedor. La combinación de los parámetros pProviderId y ProviderVersionId debe ser única. El parámetro ProviderVersionId puede ser el mismo que el parámetro ProviderVersionId de otro proveedor.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El proveedor se registró correctamente.
E_INVALIDARG
 Uno o varios de los valores de parámetro no son válidos. Por ejemplo, VSS_PROV_HARDWARE no es un tipo de proveedor válido en las versiones del sistema operativo cliente Windows.
E_OUTOFMEMORY
 Memoria insuficiente u otros recursos del sistema.
E_ACCESSDENIED
 El autor de la llamada no es un administrador.
VSS_E_PROVIDER_ALREADY_REGISTERED
 El proveedor ya se ha registrado en este equipo.
VSS_E_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

Si se actualiza el proveedor de hardware, la aplicación de instalación debe llamar al método UnregisterProvider para anular el registro de la versión obsoleta y, a continuación, llamar al método RegisterProvider para registrar el proveedor actualizado.

Nota Los proveedores de hardware solo se pueden registrar en sistemas operativos Windows Server.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsadmin.h

Consulte también

IVssAdmin

UnregisterProvider