Método IVdsAdmin::RegisterProvider (vdshwprv.h)
[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]
Registra o provedor de hardware especificado com O VDS. Os provedores de hardware chamam esse método.
Sintaxe
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
O GUID do provedor de hardware.
[in] providerClsid
O Clsid (identificador de classe COM) do provedor de hardware.
[in] pwszName
O nome do provedor de hardware como uma cadeia de caracteres legível e terminada por zero.
[in] type
Os tipos de provedor enumerados por VDS_PROVIDER_TYPE. Use o valor VDS_PT_HARDWARE para registrar um provedor de hardware com VDS.
[in] pwszMachineName
O nome do computador no qual o provedor de hardware é executado; uma cadeia de caracteres legível e terminada em nulo. Use NULL para fazer referência ao computador atual.
[in] pwszVersion
A versão do provedor como uma cadeia de caracteres legível e terminada por zero.
[in] guidVersionId
O GUID para esta versão do provedor.
Retornar valor
Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.
| Valor/código retornado | Descrição |
|---|---|
|
A providerId já está registrada. Somente uma versão de um provedor pode ser registrada a qualquer momento. |
Comentários
Se necessário, chame UnregisterProvider para remover um provedor antes de registrar uma nova versão.
Um provedor em processo chama esse método de DllRegisterServer; enquanto um provedor fora de processo chama da função WinMain .
Os provedores de hardware não devem parar de executar enquanto o VDS está em execução.
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 | vdshwprv.h |
| Biblioteca | Uuid.lib |