MsiRecordSetStringA 関数 (msiquery.h)

  • [アーティクル]

MsiRecordSetString 関数は、指定されたフィールドに文字列をコピーします。

構文

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

パラメーター

[in] hRecord

レコードへのハンドル。

[in] iField

設定するレコードのフィールドを指定します。

[in] szValue

フィールドの文字列値を指定します。

戻り値

この関数は UINT を返します。

注釈

MsiRecordSetString 関数では、null 文字列ポインターと空の文字列の両方でフィールドが null に設定されます。 存在しないフィールドに値を保存しようとすると、エラーが発生します。

レコード文字列フィールドを null に設定するには、szValue を null 文字列または空の文字列に設定します。

注意

msiquery.h ヘッダーは、MSIRecordSetString をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー
対象プラットフォーム Windows
ヘッダー msiquery.h
Library Msi.lib
[DLL] Msi.dll

こちらもご覧ください

レコード処理関数