Énumération GROUPPROP (qmgr.h)

Article
08/25/2023

[Le gestionnaire de files d’attente (QMGR) peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt le service de transfert intelligent en arrière-plan (BITS).]

L’énumération GROUPPROP définit les valeurs constantes pour la récupération et la définition des valeurs de propriétés de groupe.

Syntax

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
} ;

Constantes


`GROUPPROP_PRIORITY` Valeur : 0 Détermine quand le QMGR traite le groupe par rapport aux autres groupes de la file d’attente. Il n’y a qu’une seule priorité. Vous devez spécifier la valeur 1 lors de la définition de cette propriété. La propriété retourne toujours une valeur de 1. Le type de données variant peut être VT_I4, VT_I2, VT_UI4, VT_UI2, VT_INT ou VT_UINT.
`GROUPPROP_REMOTEUSERID` Valeur : 1 Non pris en charge.
`GROUPPROP_REMOTEUSERPWD` Valeur : 2 Non pris en charge.
`GROUPPROP_LOCALUSERID` Valeur : 3 Non pris en charge.
`GROUPPROP_LOCALUSERPWD` Valeur : 4 Non pris en charge.
`GROUPPROP_PROTOCOLFLAGS` Valeur : 5 Spécifie le protocole à utiliser pour le téléchargement. Vous devez spécifier QM_PROTOCOL_HTTP lors de la définition de cette propriété. Le type de données variant peut être VT_I4, VT_I2, VT_UI4, VT_UI2, VT_INT ou VT_UINT.
`GROUPPROP_NOTIFYFLAGS` Valeur : 6 Spécifie le type de notification d’événement à recevoir pour le groupe. Consultez la section Notes. Le type de données variant peut être VT_I4, VT_I2, VT_UI4, VT_UI2, VT_INT ou VT_UINT.
`GROUPPROP_NOTIFYCLSID` Valeur : 7 CLSID à activer lorsqu’un événement spécifié par GROUPPROP_NOTIFYFLAGS se produit. Pour plus d’informations sur l’activation du CLSID, consultez IBackgroundCopyCallback1. Le type de données Variant est VT_BSTR.
`GROUPPROP_PROGRESSSIZE` Valeur : 8 Non pris en charge.
`GROUPPROP_PROGRESSPERCENT` Valeur : 9 Non pris en charge.
`GROUPPROP_PROGRESSTIME` Valeur : 10 Non pris en charge.
`GROUPPROP_DISPLAYNAME` Valeur : 11 Spécifie un nom complet qui peut être utilisé pour identifier le groupe dans une interface utilisateur. La longueur de la chaîne est limitée à 256 caractères, sans compter la marque de fin Null. Le type de données Variant est VT_BSTR.
`GROUPPROP_DESCRIPTION` Valeur : 12 Spécifie une description à associer au groupe. La longueur de la chaîne est limitée à 1 024 caractères, à l’exception de la marque de fin Null. Le type de données Variant est VT_BSTR.

Remarques

La propriété de groupe GROUPPROP_NOTIFYFLAGS peut contenir un ou plusieurs des indicateurs de notification suivants.

Indicateur	Signification
QM_NOTIFY_FILE_DONE	Non pris en charge.
QM_NOTIFY_JOB_DONE	Non pris en charge.
QM_NOTIFY_GROUP_DONE	Notifie l’application via IBackgroundCopyCallback1 ::OnStatus que le groupe est terminé.
QM_NOTIFY_DISABLE_NOTIFY	Désactive toutes les notifications.
QM_NOTIFY_USE_PROGRESSEX	Non pris en charge.

Note Par défaut, QMGR appelle votre méthode IBackgroundCopyCallback1 ::OnStatus lorsqu’une erreur se produit.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	qmgr.h

Partager via