MsiGetFeatureUsageA 関数 (msi.h)

  • [アーティクル]

MsiGetFeatureUsage 関数は、製品機能の使用状況メトリックを返します。

構文

UINT MsiGetFeatureUsageA(
  [in]  LPCSTR  szProduct,
  [in]  LPCSTR  szFeature,
  [out] LPDWORD pdwUseCount,
  [out] LPWORD  pwDateUsed
);

パラメーター

[in] szProduct

機能を含む製品の製品コードを指定します。

[in] szFeature

メトリックを返す機能の機能コードを指定します。

[out] pdwUseCount

機能が使用された回数を示します。

[out] pwDateUsed

機能が最後に使用された日付を指定します。 次の表に示すように、日付は MS-DOS 日付形式です。

Bits 説明
0 – 4
 月の日付 (1-31)
5 – 8
 月 (1 = 1 月、2 = 2 月など)
9 – 15
 1980 年からの年オフセット (実際の年を取得するには 1980 を加算します)

戻り値

MsiGetFeatureUsage 関数は、次の値を返します。

値 説明
ERROR_BAD_CONFIGURATION
 構成データが破損しています。
ERROR_INSTALL_FAILURE
 使用情報が表示されないか、製品または機能が無効です。
ERROR_SUCCESS
 関数は正常に終了しました。

解説

注意

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

要件

   
サポートされている最小のクライアント 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 インストーラーのバージョン別に必須となる最小 Windows サービス パックに関する詳細については、Windows インストーラーの実行時の要件に関する記事を参照してください。
対象プラットフォーム Windows
ヘッダー msi.h
Library Msi.lib
[DLL] Msi.dll

関連項目

システム状態関数