Compartir a través de

Método IVdsIscsiTarget::SetFriendlyName (vds.h)

  • Artículo

[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 del destino.

Sintaxis

HRESULT SetFriendlyName(
  [in] LPWSTR pwszFriendlyName
);

Parámetros

[in] pwszFriendlyName

Cadena que especifica el nombre descriptivo que se va a asignar al destino. Esto corresponde al alias iSCSI.

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
S_OK
 El nombre descriptivo se estableció correctamente.
VDS_S_NAME_TRUNCATED
0x00042700L
 El nombre se estableció correctamente, pero tuvo que truncarse debido a limitaciones en el subsistema. Es posible que el nombre que se estableció no coincida con el nombre pasado en el parámetro pwszFriendlyName .
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 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é.
VDS_E_OBJECT_DELETED
0x8004240BL
 El objeto de destino ya no está presente.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 Otra operación está en curso; esta operación no puede continuar hasta que se completen las operaciones anteriores.
VDS_E_NOT_SUPPORTED
0x80042400L
 Este proveedor no admite esta operación o combinación de parámetros.

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 vds.h
Library Uuid.lib
Redistribuible VDS 1.1

Consulte también

IVdsIscsiTarget