Structure TUISPICREATEDIALOGINSTANCEPARAMS (tspi.h)
Définit des paramètres pour les opérations de boîte de dialogue TAPI.
Syntaxe
typedef struct tuispicreatedialoginstanceparams_tag {
DRV_REQUESTID dwRequestID;
HDRVDIALOGINSTANCE hdDlgInst;
HTAPIDIALOGINSTANCE htDlgInst;
LPCWSTR lpszUIDLLName;
LPVOID lpParams;
DWORD dwSize;
} TUISPICREATEDIALOGINSTANCEPARAMS, *LPTUISPICREATEDIALOGINSTANCEPARAMS;
Membres
dwRequestID
DwRequestID transmis au fournisseur de services en tant que paramètre dans la fonction TSPI asynchrone à laquelle l’interface utilisateur spontanée est associée. TAPI l’utilise pour identifier l’application dans laquelle la DLL d’interface utilisateur doit être chargée et la fonction TUISPI_providerGenericDialog appelée.
hdDlgInst
Identificateur du fournisseur de services pour l’association avec le instance de la boîte de dialogue générique. Étant donné qu’il est possible que plusieurs instances de la boîte de dialogue générique soient ouvertes dans la même ou plusieurs applications, le fournisseur de services doit s’assurer que son handle est unique dans l’étendue des instances existantes dans le contexte du fournisseur.
htDlgInst
TAPI écrit dans ce membre son identificateur pour l’association créée. Ce membre a la valeur NULL si la création de l’association a échoué, auquel cas il est impossible pour le fournisseur de services de créer une boîte de dialogue spontanément dans le contexte de l’application cible. Le fournisseur de services doit utiliser cet identificateur dans les messages pour envoyer des données à la DLL d’interface utilisateur (LINE_SENDDIALOGINSTANCEDATA).
lpszUIDLLName
Pointeur vers une chaîne terminée par null spécifiant le nom complet de la DLL d’interface utilisateur à charger dans le contexte de l’application.
lpParams
Pointeur vers un bloc de paramètres privé à transmettre à la fonction TUISPI_providerGenericDialog de la DLL d’interface utilisateur. Le fournisseur de services et la DLL d’interface utilisateur déterminent le contenu du bloc de paramètres. Le transfert est unidirectionnel ; la DLL d’interface utilisateur n’est pas en mesure de modifier le bloc de paramètres et de le renvoyer au fournisseur de services. En règle générale, ce bloc indique à la DLL d’interface utilisateur la boîte de dialogue à afficher et contient les informations à afficher (si nécessaire).
dwSize
Taille, en octets, du bloc de paramètres.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | tspi.h |