ITnef::SetProps
S’applique à : Outlook 2013 | Outlook 2016
Définit la valeur d’une ou de plusieurs propriétés d’un message encapsulé ou d’une pièce jointe sans modifier le message ou la pièce jointe d’origine.
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont les valeurs de propriété sont définies. L’indicateur suivant peut être défini :
TNEF_PROP_CONTAINED
Encode uniquement les propriétés du message ou de la pièce jointe spécifiée par le paramètre ulElemID .
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.
cValues
[in] Nombre de valeurs de propriété dans la structure SPropValue vers laquelle pointe le paramètre lpProps .
lpProps
[in] Pointeur vers une structure SPropValue qui contient les valeurs de propriété des propriétés à définir.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
Remarques
Les fournisseurs de transport, les fournisseurs de magasins de messages et les passerelles appellent la méthode ITnef ::SetProps pour définir les propriétés à inclure dans l’encapsulation d’un message ou d’une pièce jointe sans modifier le message ou la pièce jointe d’origine. Toutes les propriétés définies avec cet appel remplacent les propriétés existantes dans le message encapsulé.
SetProps est pris en charge uniquement pour les objets TNEF ouverts avec l’indicateur TNEF_ENCODE pour la fonction OpenTnefStream ou OpenTnefStreamEx . Vous pouvez définir n’importe quel nombre de propriétés avec cet appel.
Remarque
Aucun encodage TNEF réel pour SetProps ne se produit qu’après l’appel de la méthode ITnef ::Finish . Cette fonctionnalité signifie que les pointeurs passés dans SetProps doivent rester valides jusqu’à ce que l’appel à Finish soit effectué. À ce stade, tous les objets et données passés dans les appels SetProps peuvent être libérés ou libérés.