Método IVdsSubSystemIscsi::CreateTarget (vds.h)

Artículo
03/08/2023

[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.]

Crea un destino iSCSI. El puntero de interfaz para el nuevo objeto de destino se puede recuperar llamando a IVdsAsync::Wait a través del parámetro ppAsync . La estructura VDS_ASYNC_OUTPUT devuelta contiene el puntero de interfaz de objeto de destino en el miembro ct.pTargetUnk .

Sintaxis

HRESULT CreateTarget(
  [in]  LPWSTR    pwszIscsiName,
  [in]  LPWSTR    pwszFriendlyName,
  [out] IVdsAsync **ppAsync
);

Parámetros

[in] pwszIscsiName

Cadena que especifica el nombre iSCSI que se va a asignar al destino. El nombre de destino debe ser único en todos los destinos de todos los subsistemas visibles en la red.

Si pwszIscsiName es NULL o apunta a una cadena vacía, el proveedor generará el nombre iSCSI que se asignará al destino.

[in] pwszFriendlyName

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

[out] ppAsync

Dirección de un puntero de interfaz IVdsAsync , que VDS inicializa al devolver. Los autores de llamadas deben liberar la interfaz. Use esta interfaz para cancelar, esperar o consultar el estado de la operación. Si llama a IVdsAsync::Wait en este método y se devuelve un valor HRESULT correcto, debe liberar las interfaces devueltas en la estructura VDS_ASYNC_OUTPUT llamando al método IUnknown::Release en cada puntero de interfaz. Sin embargo, si Wait devuelve un valor HRESULT de error o si el parámetro pHrResult de Wait recibe un valor HRESULT de error, los punteros de interfaz de la estructura VDS_ASYNC_OUTPUT son NULL y no es necesario liberar. Puede probar los valores HRESULT correctos o erróneos mediante las macros SUCCEEDED y FAILED definidas en Winerror.h.

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 destino se creó correctamente.
VDS_E_NOT_SUPPORTED 0x80042400L	El objeto del subsistema no admite este método. Esto indica que el proveedor de hardware ha establecido la marca VDS_SF_SUPPORTS_SIMPLE_TARGET_CONFIG en el miembro ulFlags de la estructura de VDS_SUB_SYSTEM_PROP para el objeto del subsistema.
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 del subsistema ya no está presente.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	El subsistema está en estado de error y no puede realizar la operación solicitada.
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_NAME_NOT_UNIQUE 0x80042701L	Se especificó un nombre no único en el parámetro pwszIscsiName .

Requisitos


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