Метод IVdsVDisk::Open (vds.h)

[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Открывает дескриптор для указанного файла виртуального диска и возвращает указатель интерфейса IVdsOpenVDisk на объект , представляющий открытый дескриптор.

Синтаксис

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

Параметры

[in] AccessMask

Битовая маска флагов VIRTUAL_DISK_ACCESS_MASK , указывающих права доступа, применяемые к открытому виртуальному диску.

[in] Flags

Битовая маска OPEN_VIRTUAL_DISK_FLAG флагов, указывающих способ открытия виртуального диска.

[in] ReadWriteDepth

Количество хранилищ (резервных файлов), начиная с дочернего элемента, в цепочке резервных хранилищ для открытия операций чтения и записи. Остальные хранилища в разностной цепочке будут открыты только для чтения. (Это необходимо для успешного выполнения операций слияния.)

[out] ppOpenVDisk

Указатель на переменную, получающую указатель интерфейса IVdsOpenVDisk на вновь созданный объект, представляющий дескриптор, открытый для объекта виртуального диска. Вызывающие элементы должны освободить указатель интерфейса, если он больше не нужен, вызвав метод IUnknown::Release .

Возвращаемое значение

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать преобразованные коды системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Код возврата	Описание
S_OK	Метод завершился успешно.

Комментарии

Приложения должны инициализировать безопасность на уровне процесса путем вызова функции CoInitializeSecurity . Параметру dwImpLevel должно быть присвоено значение RPC_C_IMP_LEVEL_IMPERSONATE.

Windows Server 2008, Windows Vista и Windows Server 2003: Эти действия не требуются до Windows 7 и Windows Server 2008 R2.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	vds.h
Библиотека	Uuid.lib

См. также раздел

IVdsVDisk