ITnef::AddProps

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Permet au fournisseur de services appelant ou à la passerelle d’ajouter des propriétés à l’encapsulation d’un message ou d’une pièce jointe.

HRESULT AddProps(
  ULONG ulFlags,
  ULONG ulElemID,
  LPVOID lpvData,
  LPSPropTagArray lpPropList
);

Paramètres

ulFlags

[in] Masque de bits d’indicateurs qui contrôle la façon dont les propriétés sont incluses ou exclues de l’encapsulation. Les indicateurs suivants peuvent être définis :

TNEF_PROP_ATTACHMENTS_ONLY

Encode uniquement les propriétés du paramètre lpPropList qui font partie des pièces jointes du message.

TNEF_PROP_CONTAINED

Encode uniquement les propriétés de la pièce jointe spécifiée par le paramètre ulElemID . Si le paramètre lpvData n’a pas la valeur NULL, les données pointées sont écrites dans l’encapsulation de la pièce jointe dans le fichier indiqué par la propriété PR_ATTACH_TRANSPORT_NAME (PidTagAttachTransportName).

TNEF_PROP_CONTAINED_TNEF

Encode uniquement les propriétés du message ou de la pièce jointe spécifiée par le paramètre ulElemID . Si cet indicateur est défini, la valeur dans lpvData doit être un pointeur IStream .

TNEF_PROP_EXCLUDE

Encode toutes les propriétés non spécifiées dans le paramètre lpPropList .

TNEF_PROP_INCLUDE

Encode toutes les propriétés spécifiées dans lpPropList.

TNEF_PROP_MESSAGE_ONLY

Encode uniquement les propriétés spécifiées dans lpPropList qui font partie du message lui-même.

ulElemID

[in] La propriété PR_ATTACH_NUM (PidTagAttachNumber) d’une pièce jointe, qui contient un nombre qui identifie de façon unique la pièce jointe dans son message parent. Le paramètre ulElemID est utilisé quand une gestion spéciale est demandée pour une pièce jointe. Le paramètre ulElemID doit avoir la valeur 0, sauf si l’indicateur TNEF_PROP_CONTAINED ou TNEF_PROP_CONTAINED_TNEF est défini dans le paramètre ulFlags .

lpvData

[in] Pointeur vers les données de pièce jointe utilisées pour remplacer les données de la pièce jointe spécifiée dans ulElemID. Le paramètre lpvData doit avoir la valeur NULL, sauf si TNEF_PROP_CONTAINED ou TNEF_PROP_CONTAINED_TNEF est défini dans ulFlags.

lpPropList

[in] Pointeur vers la liste des propriétés à inclure dans ou à exclure de l’encapsulation.

Valeur renvoyée

S_OK

L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.

Remarques

Les fournisseurs de transport, les fournisseurs de magasins de messages et les passerelles appellent la méthode ITnef ::AddProps pour répertorier les propriétés à inclure ou exclure du traitement TNEF (Encapsulation Format) Transport-Neutral d’un message ou d’une pièce jointe. En utilisant des appels successifs, le fournisseur ou la passerelle peut spécifier une liste de propriétés à ajouter et à encoder ou à exclure de l’encodage. Les fournisseurs et les passerelles peuvent également utiliser AddProps pour fournir des informations sur les pièces jointes de gestion spéciale qui doivent être fournies.

AddProps est pris en charge uniquement pour les objets TNEF ouverts avec l’indicateur TNEF_ENCODE pour la fonction OpenTnefStream ou OpenTnefStreamEx .

Notez qu’aucun encodage TNEF réel ne se produit pour AddProps tant que la méthode ITnef ::Finish n’est pas appelée. Cette fonctionnalité signifie que les pointeurs passés dans AddProps doivent rester valides jusqu’à ce que l’appel à Finish soit effectué. À ce stade, tous les objets et données transmis avec les appels AddProps peuvent être libérés ou libérés.