Método IVdsController::GetPortProperties (vdshwprv.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 las propiedades del puerto del controlador especificado.
Sintaxis
HRESULT GetPortProperties(
[in] SHORT sPortNumber,
[out] VDS_PORT_PROP *pPortProp
);
Parámetros
[in] sPortNumber
Número del puerto. Los números de puerto son permanentes. Los puertos se numeran de 0.
[out] pPortProp
Dirección de una estructura de VDS_PORT_PROP asignada y pasada por el autor de la llamada. VDS asigna memoria para las cadenas de miembro pwszFriendlyName y pwszIdentification . Los autores de llamadas deben liberar las cadenas mediante la función CoTaskMemFree .
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 pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
Este valor devuelto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre la matriz. Use el método IVdsHwProvider::Reenumerate seguido del método IVdsHwProvider::Refresh para restaurar la memoria caché. |
|
El objeto de controlador ya no está presente. |
|
Este proveedor no admite esta operación o combinación de parámetros. |
Comentarios
Use el método IVdsController::GetProperties para obtener el número total de puertos.
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 | vdshwprv.h |
| Library | Uuid.lib |