Metodo IVdsService::QueryProviders (vds.h)

  • Articolo

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

Restituisce un oggetto di enumerazione contenente un elenco dei provider hardware e software noti per VDS.

Sintassi

HRESULT QueryProviders(
  [in]  DWORD          masks,
  [out] IEnumVdsObject **ppEnum
);

Parametri

[in] masks

Maschera del provider enumerata da VDS_QUERY_PROVIDER_FLAG. I chiamanti possono specificare una maschera del provider software, una maschera del provider hardware o entrambi.

[out] ppEnum

Indirizzo di un puntatore dell'interfaccia IEnumVdsObject che può essere usato per enumerare i provider come oggetti provider. Per altre informazioni, vedere Uso degli oggetti di enumerazione. I chiamanti devono rilasciare l'interfaccia e ognuno degli oggetti provider quando non sono più necessari 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.

Codice/valore restituito Descrizione
S_OK
 L'enumerazione viene restituita correttamente.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Non è stato possibile inizializzare il VDS. Se un'applicazione chiama questo metodo prima che il servizio finisca l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore.

Commenti

Per determinare il tipo di provider per i provider hardware, chiamare il metodo IVdsHwProviderType2::GetProviderType2 o il metodo IVdsHwProviderType::GetProviderType per ogni oggetto provider.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vds.h
Libreria Uuid.lib

Vedi anche

IEnumVdsObject

IVdsService

VDS_HWPROVIDER_TYPE

VDS_QUERY_PROVIDER_FLAG