Метод IDiscFormat2Erase::p ut_ClientName (imapi2.h)
Задает понятное имя клиента.
Синтаксис
HRESULT put_ClientName(
[in] BSTR value
);
Параметры
[in] value
Имя клиентского приложения.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Не удалось выделить необходимую память.
Значение: 0x8007000E |
|
Один или несколько аргументов недопустимы.
Значение: 0x80070057 |
Комментарии
Имя используется, когда операция записи запрашивает монопольный доступ к устройству. Свойство IDiscRecorder2::get_ExclusiveAccessOwner содержит имя клиента с блокировкой.
Так как любое приложение с доступом на чтение и запись к устройству CDROM во время операции очистки может использовать код управления IOCTL_CDROM_EXCLUSIVE_ACCESS (запрос) (см. пакет средств разработки драйверов Microsoft Windows (DDK)) для доступа к имени, важно, чтобы имя идентифицировать программу, которая использует этот интерфейс для удаления на носитель. Имя ограничено тем же набором символов, что и для кода элемента управления IOCTL_CDROM_EXCLUSIVE_ACCESS.
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |