Metodo IVdsSubSystemNaming::SetFriendlyName (vds.h)
[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]
Imposta il nome descrittivo di un sottosistema.
Sintassi
HRESULT SetFriendlyName(
LPWSTR pwszFriendlyName
);
Parametri
pwszFriendlyName
Puntatore a una stringa con terminazione Null che specifica il nome da assegnare al sottosistema.
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 |
|---|---|
|
Il nome è stato impostato correttamente. |
|
Il nome è stato impostato correttamente, ma deve essere troncato a causa delle limitazioni nel sottosistema. Il nome impostato potrebbe non corrispondere al nome passato nel parametro pwszName . |
|
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. |
|
L'oggetto sottosistema non è più presente. |
|
Il sottosistema si trova in uno stato di errore e non è in grado di eseguire l'operazione richiesta. |
|
È in corso un'altra operazione. Questa operazione non può continuare fino al completamento delle operazioni precedenti. |
|
Questa operazione non è supportata da questo provider. |
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 |