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

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

  • Статья

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

Синтаксис

HRESULT put_ClientName(
  [in] BSTR value
);

Параметры

[in] value

Имя клиентского приложения.

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

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

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

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

Значение: 0xC0AA050F
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS
 Выполняется операция записи.

Значение: 0xC0AA0500
E_IMAPI_DF2TAO_MEDIA_IS_PREPARED
 Запрошенная операция недопустима, если носитель был "подготовлен", но не освобожден.

Значение: 0xC0AA0503

Комментарии

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

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

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::get_ClientName