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

Перечисление GROUPPROP (qmgr.h)

  • Статья

[Диспетчер очередей (QMGR) доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте фоновую интеллектуальную службу передачи (BITS).]

Перечисление GROUPPROP определяет значения констант для получения и задания значений свойств группы.

Синтаксис

typedef enum GROUPPROP {
  GROUPPROP_PRIORITY = 0,
  GROUPPROP_REMOTEUSERID = 1,
  GROUPPROP_REMOTEUSERPWD = 2,
  GROUPPROP_LOCALUSERID = 3,
  GROUPPROP_LOCALUSERPWD = 4,
  GROUPPROP_PROTOCOLFLAGS = 5,
  GROUPPROP_NOTIFYFLAGS = 6,
  GROUPPROP_NOTIFYCLSID = 7,
  GROUPPROP_PROGRESSSIZE = 8,
  GROUPPROP_PROGRESSPERCENT = 9,
  GROUPPROP_PROGRESSTIME = 10,
  GROUPPROP_DISPLAYNAME = 11,
  GROUPPROP_DESCRIPTION = 12
} ;

Константы

 
GROUPPROP_PRIORITY
Значение: 0
Определяет, когда QMGR обрабатывает группу относительно других групп в очереди.

Существует только один приоритет. При задании этого свойства необходимо указать значение 1. Свойство всегда возвращает значение 1.

Тип данных Variant может быть VT_I4, VT_I2, VT_UI4, VT_UI2, VT_INT или VT_UINT.
GROUPPROP_REMOTEUSERID
Значение: 1
Не поддерживается.
GROUPPROP_REMOTEUSERPWD
Значение: 2
Не поддерживается.
GROUPPROP_LOCALUSERID
Значение: 3
Не поддерживается.
GROUPPROP_LOCALUSERPWD
Значение: 4
Не поддерживается.
GROUPPROP_PROTOCOLFLAGS
Значение: 5
Указывает протокол, используемый для скачивания.

При установке этого свойства необходимо указать QM_PROTOCOL_HTTP.

Тип данных Variant может быть VT_I4, VT_I2, VT_UI4, VT_UI2, VT_INT или VT_UINT.
GROUPPROP_NOTIFYFLAGS
Значение: 6
Указывает тип уведомления о событии, которое будет получаться для группы. См. заметки.

Тип данных Variant может быть VT_I4, VT_I2, VT_UI4, VT_UI2, VT_INT или VT_UINT.
GROUPPROP_NOTIFYCLSID
Значение: 7
CLSID, активируемый при возникновении события , указанного GROUPPROP_NOTIFYFLAGS . Дополнительные сведения об активации CLSID см. в разделе IBackgroundCopyCallback1.

Тип данных Variant — VT_BSTR.
GROUPPROP_PROGRESSSIZE
Значение: 8
Не поддерживается.
GROUPPROP_PROGRESSPERCENT
Значение: 9
Не поддерживается.
GROUPPROP_PROGRESSTIME
Значение: 10
Не поддерживается.
GROUPPROP_DISPLAYNAME
Значение: 11
Указывает отображаемое имя, которое можно использовать для идентификации группы в пользовательском интерфейсе. Длина строки ограничена 256 символами, не включая признак конца NULL.

Тип данных Variant — VT_BSTR.
GROUPPROP_DESCRIPTION
Значение: 12
Указывает описание, которое необходимо связать с группой. Длина строки ограничена 1024 символами, не включая признак конца NULL.

Тип данных Variant — VT_BSTR.

Комментарии

Свойство группы GROUPPROP_NOTIFYFLAGS может содержать один или несколько следующих флагов уведомлений.

Flag Значение
QM_NOTIFY_FILE_DONE Не поддерживается.
QM_NOTIFY_JOB_DONE Не поддерживается.
QM_NOTIFY_GROUP_DONE Уведомляет приложение с помощью IBackgroundCopyCallback1::OnStatus о том, что группа завершена.
QM_NOTIFY_DISABLE_NOTIFY Отключает все уведомления.
QM_NOTIFY_USE_PROGRESSEX Не поддерживается.
 
Примечание По умолчанию QMGR вызывает метод IBackgroundCopyCallback1::OnStatus при возникновении ошибки.
 

Требования

Требование Значение
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Верхняя часть qmgr.h