Método IVdsLunNaming::SetFriendlyName (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.]
Establece el nombre descriptivo de un LUN.
Sintaxis
HRESULT SetFriendlyName(
LPWSTR pwszFriendlyName
);
Parámetros
pwszFriendlyName
Puntero a una cadena terminada en null que especifica el nombre que se va a asignar al LUN.
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 |
|---|---|
|
El nombre se estableció correctamente. |
|
El nombre se estableció correctamente, pero tuvo que truncarse debido a limitaciones en el subsistema. El nombre que se estableció podría no coincidir con el nombre pasado en el parámetro pwszName . |
|
La memoria caché del proveedor está dañada. Esto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre los dispositivos conectados. El autor de la llamada puede usar el método IVdsHwProvider::Reenumerate seguido del método IVdsHwProvider::Refresh para restaurar la memoria caché. |
|
El objeto LUN ya no está presente. |
|
El LUN está en estado de error y no puede realizar la operación solicitada. |
|
Otra operación está en curso. Esta operación no puede continuar hasta que se completen las operaciones anteriores. |
|
Este proveedor no admite esta operación. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vdshwprv.h |