Metodo IVdsVDisk::Open (vds.h)

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Apre un handle al file di disco virtuale specificato e restituisce un puntatore dell'interfaccia IVdsOpenVDisk all'oggetto che rappresenta l'handle aperto.

Sintassi

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

Parametri

[in] AccessMask

Maschera di bit di flag di VIRTUAL_DISK_ACCESS_MASK che specificano i diritti di accesso da applicare al disco virtuale aperto.

[in] Flags

Maschera di bit di flag di OPEN_VIRTUAL_DISK_FLAG che specificano la modalità di apertura del disco virtuale.

[in] ReadWriteDepth

Numero di archivi (file di backup), a partire dal figlio, della catena di archivi di backup per aprire lettura/scrittura. Gli archivi rimanenti nella catena di differenze verranno aperti di sola lettura. Questa operazione è necessaria per l'esito positivo delle operazioni di merge.

[out] ppOpenVDisk

Puntatore a una variabile che riceve un puntatore dell'interfaccia IVdsOpenVDisk all'oggetto appena creato che rappresenta l'handle aperto all'oggetto disco virtuale. I chiamanti devono rilasciare il puntatore dell'interfaccia quando non è più necessario chiamando il metodo IUnknown::Release .

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Commenti

Le applicazioni devono inizializzare la sicurezza a livello di processo chiamando la funzione CoInitializeSecurity . Il parametro dwImpLevel deve essere impostato su RPC_C_IMP_LEVEL_IMPERSONATE.

Windows Server 2008, Windows Vista e Windows Server 2003: Queste azioni non sono necessarie fino a Windows 7 e Windows Server 2008 R2.

Requisiti

Vedi anche

IVdsVDisk