Metodo IVdsController::GetPortProperties (vdshwprv.h)

Articolo
03/03/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 le proprietà della porta del controller specificata.

Sintassi

HRESULT GetPortProperties(
  [in]  SHORT         sPortNumber,
  [out] VDS_PORT_PROP *pPortProp
);

Parametri

[in] sPortNumber

Numero della porta. I numeri di porta sono permanenti. Le porte sono numerate da 0.

[out] pPortProp

Indirizzo di una struttura VDS_PORT_PROP allocata e passata dal chiamante. VDS alloca memoria per le stringhe dei membri pwszFriendlyName e pwszIdentification . I chiamanti devono liberare le stringhe usando la funzione CoTaskMemFree .

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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Questo valore restituito segnala un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sulla matrice. Usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider ::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED 0x8004240BL	L'oggetto controller non è più presente.
VDS_E_NOT_SUPPORTED 0x80042400L	Questa operazione o combinazione di parametri non è supportata da questo provider.

Commenti

Usare il metodo IVdsController::GetProperties per ottenere il numero totale di porte.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vdshwprv.h
Libreria	Uuid.lib