Método IVdsAdmin::RegisterProvider (vdshwprv.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Registra el proveedor de hardware especificado con VDS. Los proveedores de hardware llaman a este método.

Sintaxis

HRESULT RegisterProvider(
  [in] VDS_OBJECT_ID     providerId,
  [in] CLSID             providerClsid,
  [in] LPWSTR            pwszName,
  [in] VDS_PROVIDER_TYPE type,
  [in] LPWSTR            pwszMachineName,
  [in] LPWSTR            pwszVersion,
  [in] GUID              guidVersionId
);

Parámetros

[in] providerId

GUID del proveedor de hardware.

[in] providerClsid

Identificador de clase COM (Clsid) del proveedor de hardware.

[in] pwszName

Nombre del proveedor de hardware como una cadena legible y terminada en cero.

[in] type

Tipos de proveedor enumerados por VDS_PROVIDER_TYPE. Use el valor de VDS_PT_HARDWARE para registrar un proveedor de hardware con VDS.

[in] pwszMachineName

Nombre del equipo en el que se ejecuta el proveedor de hardware; una cadena legible terminada en null. Use NULL para hacer referencia al equipo actual.

[in] pwszVersion

La versión del proveedor como una cadena legible y terminada en cero.

[in] guidVersionId

GUID de esta versión del proveedor.

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto	Descripción
VDS_E_ALREADY_REGISTERED 0x80042403L	El valor providerId ya está registrado. Solo se puede registrar una versión de un proveedor en un momento dado.

Comentarios

Si es necesario, llame a UnregisterProvider para quitar un proveedor antes de registrar una nueva versión.

Un proveedor en proceso llama a este método desde DllRegisterServer; mientras que un proveedor fuera de proceso llama desde la función WinMain .

Los proveedores de hardware no deben dejar de ejecutarse mientras se ejecuta VDS.

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	vdshwprv.h
Library	Uuid.lib

Consulte también

IVdsAdmin

IVdsAdmin::UnregisterProvider

VDS_PROVIDER_TYPE