Método IVdsIscsiTarget::CreatePortalGroup (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.]
Crea un grupo de portal. El puntero de interfaz para el nuevo objeto de grupo de portal 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 volumen en el miembro cpg.pPortalGroupUnk .
Sintaxis
HRESULT CreatePortalGroup(
[out] IVdsAsync **ppAsync
);
Parámetros
[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 al método IVdsAsync::Wait en esta interfaz y se devuelve un valor HRESULT correcto, debe liberar las interfaces devueltas en la estructura de 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 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 |
|---|---|
|
El grupo del portal se creó correctamente. |
|
No se pueden crear más grupos de portal. El método CreatePortalGroup no creó un nuevo grupo de portal. Si llama al método IVdsAsync::Wait en el puntero de interfaz devuelto en el parámetro ppAsync , se recupera un objeto de grupo de portal existente. |
|
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 de destino ya no está presente. |
|
Otra operación está en curso; esta operación no puede continuar hasta que se completen las operaciones anteriores. |
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 |
| Library | Uuid.lib |
| Redistribuible | VDS 1.1 |