Método IVdsVDisk::Open (vds.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.]

Abre un identificador para el archivo de disco virtual especificado y devuelve un puntero de interfaz IVdsOpenVDisk al objeto que representa el identificador abierto.

Sintaxis

HRESULT Open(
  [in]  VIRTUAL_DISK_ACCESS_MASK AccessMask,
  [in]  OPEN_VIRTUAL_DISK_FLAG   Flags,
  [in]  ULONG                    ReadWriteDepth,
  [out] IVdsOpenVDisk            **ppOpenVDisk
);

Parámetros

[in] AccessMask

Máscara de bits de VIRTUAL_DISK_ACCESS_MASK marcas que especifican los derechos de acceso que se aplicarán al disco virtual abierto.

[in] Flags

Máscara de bits de OPEN_VIRTUAL_DISK_FLAG marcas que especifican cómo se va a abrir el disco virtual.

[in] ReadWriteDepth

El número de almacenes (archivos de respaldo), empezando por el elemento secundario, de la cadena de almacenamiento de respaldo para abrir lectura y escritura. Los almacenes restantes de la cadena de diferenciación se abrirán de solo lectura. (Esto es necesario para que las operaciones de combinación se realicen correctamente).

[out] ppOpenVDisk

Puntero a una variable que recibe un puntero de interfaz IVdsOpenVDisk al objeto recién creado que representa el identificador abierto al objeto de disco virtual. Los autores de llamadas deben liberar el puntero de interfaz cuando ya no sea necesario mediante una llamada al método IUnknown::Release .

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 se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Comentarios

Las aplicaciones deben inicializar la seguridad de todo el proceso mediante una llamada a la función CoInitializeSecurity . El parámetro dwImpLevel debe establecerse en RPC_C_IMP_LEVEL_IMPERSONATE.

Windows Server 2008, Windows Vista y Windows Server 2003: Estas acciones no son necesarias hasta Windows 7 y Windows Server 2008 R2.

Requisitos

Consulte también

IVdsVDisk