Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
[A partir do Windows 8 e do Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]
Define o nome amigável do destino.
Sintaxe
HRESULT SetFriendlyName(
[in] LPWSTR pwszFriendlyName
);
Parâmetros
[in] pwszFriendlyName
Uma cadeia de caracteres que especifica o nome amigável a ser atribuído ao destino. Isso corresponde ao alias iSCSI.
Valor de retorno
Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os valores retornados possíveis incluem o seguinte.
| Código/valor de retorno | Description |
|---|---|
|
O nome amigável foi definido com êxito. |
|
O nome foi definido com êxito, mas teve que ser truncado devido a limitações no subsistema. O nome que foi definido pode não corresponder ao nome passado no parâmetro pwszFriendlyName . |
|
O cache do provedor está corrompido. Isso indica um problema de software ou comunicação dentro de um provedor que armazena em cache informações sobre os dispositivos anexados. O chamador pode usar o método IVdsHwProvider::Reenumerate seguido pelo método IVdsHwProvider::Refresh para restaurar o cache. |
|
O objeto de destino não está mais presente. |
|
Outra operação está em andamento; esta operação não pode continuar até que as operações anteriores sejam concluídas. |
|
Não há suporte para essa operação ou combinação de parâmetros por esse provedor. |
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo compatível | Windows Server 2003 R2 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino | Windows |
| Header | vds.h |
| Library | Uuid.lib |
| Redistribuível | VDS 1.1 |