Énumération GROUPPROP (qmgr.h)
[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 |