Compartilhar via


IServerVirtualDeviceSet2::OpenDevice (VDI)

Aplica-se: SQL Server

A função OpenDevice obtém interfaces de dispositivo virtual do conjunto de dispositivos virtuais.

Sintaxe

HRESULT IServerVirtualDeviceSet2::OpenDevice (
   LPCWSTR                     lpName,
   IServerVirtualDevice**      ppVirtualDevice
);

Parâmetros

lpName Isso é fornecido pela primeira cláusula VIRTUAL_DEVICE= do comando BACKUP ou RESTORE. Esse nome é usado como a chave para obter acesso ao conjunto de dispositivos virtuais criado pelo cliente.

ppVirtualDevice Isso é usado para retornar uma interface de dispositivo virtual.

Valor de retorno

Valor de retorno Explicação
NOERROR A função foi bem-sucedida.
VD_E_OPEN Todos os dispositivos foram abertos.

Comentários

Cada chamada retorna o próximo dispositivo não aberto. A função pode ser chamada apenas pelo número de vezes igual ao número de dispositivos especificados na configuração do conjunto de dispositivos virtuais.

Próximas etapas

Para obter mais informações, confira a Visão geral da referência da interface de dispositivo virtual do SQL Server.