Método IVdsService::QueryUnallocatedDisks (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.]
Devuelve un objeto de enumeración que contiene una lista de los discos sin asignar administrados por VDS.
Sintaxis
HRESULT QueryUnallocatedDisks(
[out] IEnumVdsObject **ppEnum
);
Parámetros
[out] ppEnum
Dirección de un puntero de interfaz IEnumVdsObject que se puede usar para enumerar los discos como objetos de disco. Para obtener más información, vea Trabajar con objetos de enumeración. Los autores de llamadas deben liberar la interfaz y cada uno de los objetos de disco cuando ya no sean necesarios 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.
| Código o valor devuelto | Descripción |
|---|---|
|
La enumeración se devolvió correctamente. |
|
VDS no se pudo inicializar. Si una aplicación llama a este método antes de que el servicio termine de inicializarse, el método se bloqueará hasta que se complete la inicialización. Si se produce un error en la inicialización, se devuelve este error. |
Comentarios
Ningún proveedor no reclama un disco sin asignar. Puede o no contener información de formato de partición MBR o GPT. A menudo es un disco no inicializado. Si el estado del disco es VDS_DS_ONLINE o VDS_DS_OFFLINE, el disco no se asigna y no se inicializa. Si se VDS_DS_UNKNOWN, VDS_DS_NOT_READY, VDS_DS_FAILED o VDS_DS_MISSING, no se asigna, pero el servicio VDS no puede determinar si se inicializa o no, posiblemente debido a problemas con el disco.
Para determinar el estado del disco, consulte el miembro de estado del VDS_DISK_PROP o VDS_DISK_PROP2 estructura del disco.
Si el estado del disco es VDS_DS_ONLINE, el disco se puede agregar a un paquete.
Si el estado del disco es VDS_DS_OFFLINE, intente conectar el disco mediante una llamada a IVdsDiskOnline::Online. Si la llamada al método Online se realiza correctamente, el disco se puede agregar a un paquete. Si se produce un error en la llamada a Online , no se puede usar el disco.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vds.h |
| Library | Uuid.lib |