Partager via


É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