Метод IVdsSubSystemNaming::SetFriendlyName (vds.h)
[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Задает понятное имя подсистемы.
Синтаксис
HRESULT SetFriendlyName(
LPWSTR pwszFriendlyName
);
Параметры
pwszFriendlyName
Указатель на строку, завершающуюся значением NULL, указывающую имя, присваиваемое подсистеме.
Возвращаемое значение
Этот метод может возвращать стандартные значения HRESULT , такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать преобразованные коды системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.
Возвращаемый код или значение | Описание |
---|---|
|
Имя успешно задано. |
|
Имя было задано успешно, но его пришлось усекать из-за ограничений в подсистеме. Заданное имя может не совпадать с именем, переданным в параметре pwszName . |
|
Кэш поставщика поврежден. Это указывает на проблемы с программным обеспечением или связью внутри поставщика, который кэширует сведения о подключенных устройствах. Вызывающий объект может использовать метод IVdsHwProvider::Reenumerate , за которым следует метод IVdsHwProvider::Refresh для восстановления кэша. |
|
Объект подсистемы больше не присутствует. |
|
Подсистема находится в состоянии сбоя и не может выполнить запрошенную операцию. |
|
Выполняется еще одна операция. Эта операция не может продолжаться до завершения предыдущих операций. |
|
Эта операция не поддерживается этим поставщиком. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 R2 [только классические приложения] |
Целевая платформа | Windows |
Header | vds.h |
Библиотека | Uuid.lib |