Metodo IVdsIscsiTarget::GetConnectedInitiators (vds.h)

Articolo
03/09/2024

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Restituisce l'elenco dei nomi iSCSI degli iniziatori attualmente connessi alla destinazione.

Sintassi

HRESULT GetConnectedInitiators(
  [out] LPWSTR **pppwszInitiatorList,
  [out] LONG   *plNumberOfInitiators
);

Parametri

[out] pppwszInitiatorList

Indirizzo di una variabile che riceve una matrice di stringhe contenente i nomi iSCSI degli iniziatori attualmente connessi alla destinazione. I chiamanti devono liberare ogni stringa in questa matrice, nonché la matrice stessa, usando la funzione CoTaskMemFree .

[out] plNumberOfInitiators

Puntatore al numero di stringhe restituite in pppwszInitiatorList.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	L'elenco degli iniziatori connessi è stato restituito correttamente.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Un'altra operazione è in corso; questa operazione non può continuare fino al completamento delle operazioni precedenti.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	La cache del provider è danneggiata. Questo indica un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sui dispositivi collegati. Il chiamante può usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED 0x8004240BL	L'oggetto di destinazione non è più presente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib
Componente ridistribuibile	VDS 1.1

Vedi anche

IVdsIscsiTarget

Condividi tramite