CreateTable
S’applique à : Outlook 2013 | Outlook 2016
Crée des structures et un handle d’objet pour un objet ITableData qui peut être utilisé pour créer du contenu de table.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapiutil.h |
| Implémenté par : |
MAPI |
| Appelé par : |
Applications clientes et fournisseurs de services |
SCODE CreateTable(
LPCIID lpInterface,
ALLOCATEBUFFER FAR * lpAllocateBuffer,
ALLOCATEMORE FAR * lpAllocateMore,
FREEBUFFER FAR * lpFreeBuffer,
LPVOID lpvReserved,
ULONG ulTableType,
ULONG ulPropTagIndexColumn,
LPSPropTagArray lpSPropTagArrayColumns,
LPTABLEDATA FAR * lppTableData
);
Paramètres
lpInterface
[in] Pointeur vers un identificateur d’interface (IID) pour l’objet de données de table. L’identificateur d’interface valide est IID_IMAPITableData. La transmission de la valeur NULL dans le paramètre lpInterface entraîne également la conversion de l’objet de données de table retourné dans le paramètre lppTableData dans l’interface standard d’un objet de données de table.
lpAllocateBuffer
[in] Pointeur vers la fonction MAPIAllocateBuffer , à utiliser pour allouer de la mémoire.
lpAllocatePlus
[in] Pointeur vers la fonction MAPIAllocateMore , à utiliser pour allouer de la mémoire supplémentaire.
lpFreeBuffer
[in] Pointeur vers la fonction MAPIFreeBuffer , à utiliser pour libérer de la mémoire.
lpvReserved
[in] R�serv� ; doit �tre �gal � z�ro.
ulTableType
[in] Type de table disponible pour une application cliente ou un fournisseur de services dans le cadre du fichier IMAPITable ::GetStatus retourne des données sur ses vues de table. Les valeurs possibles sont les suivantes :
TBLTYPE_DYNAMIC
Le contenu de la table est dynamique et peut changer à mesure que les données sous-jacentes changent.
TBLTYPE_KEYSET
Les lignes de la table sont fixes, mais les valeurs de ces lignes sont dynamiques et peuvent changer à mesure que les données sous-jacentes changent.
TBLTYPE_SNAPSHOT
La table est statique et son contenu ne change pas lorsque les données sous-jacentes changent.
ulPropTagIndexColumn
[in] Numéro d’index de la colonne à utiliser lors de la modification des données de table.
lpSPropTagArrayColumns
[in] Pointeur vers une structure SPropTagArray qui contient un tableau de balises de propriété indiquant les propriétés requises dans la table pour laquelle l’objet contient des données.
lppTableData
[out] Pointeur vers un pointeur vers l’objet de données de table retourné.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
Remarques
Les paramètres d’entrée lpAllocateBuffer, lpAllocateMore et lpFreeBuffer pointent vers les fonctions MAPIAllocateBuffer, MAPIAllocateMore et MAPIFreeBuffer , respectivement. Une application cliente appelant CreateTable passe des pointeurs vers les fonctions MAPI qui viennent d’être nommées ; un fournisseur de services transmet les pointeurs à ces fonctions qu’il a reçues dans son appel d’initialisation ou récupérés avec un appel à la méthode IMAPISupport ::GetMemAllocRoutines .