Поделиться через

Метод IDiscFormat2Data::p ut_ClientName (imapi2.h)

  • Статья

Задает понятное имя клиента.

Синтаксис

HRESULT put_ClientName(
  [in] BSTR value
);

Параметры

[in] value

Имя клиентского приложения. Не может иметь значение NULL или пустая строка.

Возвращаемое значение

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата Описание
E_OUTOFMEMORY
 Не удалось выделить необходимую память.

Значение: 0x8007000E
E_IMAPI_DF2DATA_CLIENT_NAME_IS_NOT_VALID
 Недопустимое имя клиента.

Значение: 0xC0AA0211
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS
 В настоящее время выполняется операция записи.

Значение: 0xC0AA0500

Комментарии

Имя используется, когда операция записи запрашивает монопольный доступ к устройству. Свойство 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

См. также раздел

IDiscFormat2Data

IDiscFormat2Data::get_ClientName