Partager via


MsiRecordSetStringA, fonction (msiquery.h)

La fonction MsiRecordSetString copie une chaîne dans le champ désigné.

Syntaxe

UINT MsiRecordSetStringA(
  [in] MSIHANDLE hRecord,
  [in] UINT      iField,
  [in] LPCSTR    szValue
);

Paramètres

[in] hRecord

Gérez l’enregistrement.

[in] iField

Spécifie le champ de l’enregistrement à définir.

[in] szValue

Spécifie la valeur de chaîne du champ.

Valeur retournée

Cette fonction retourne UINT.

Remarques

Dans la fonction MsiRecordSetString , un pointeur de chaîne null et une chaîne vide définissent tous deux le champ sur null. La tentative de stockage d’une valeur dans un champ inexistant provoque une erreur.

Pour définir un champ de chaîne d’enregistrement sur null, définissez szValue sur une chaîne null ou une chaîne vide.

Notes

L’en-tête msiquery.h définit MsiRecordSetString comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
Plateforme cible Windows
En-tête msiquery.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions de traitement des enregistrements