SetupConfigureWmiFromInfSectionA 関数 (setupapi.h)

[この機能は、[要件] セクションに示されているオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、Windows インストーラーを使用してアプリケーション インストーラーを開発します。 SetupAPI は、デバイス ドライバーのインストールに引き続き使用されます。

SetupConfigureWmiFromInfSection 関数は、[DDInstall.WMI] セクションに渡されたときに INF ファイルによって公開される WMI データのセキュリティを構成します。

これは、システム上の SetupAPI のバージョンが INF ファイルの DDInstall セクションで提供される WMI セキュリティ情報をネイティブにサポートしていない場合にセキュリティを確立するために使用されます。

構文

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

パラメーター

[in] InfHandle

開いている INF ファイルへのハンドル。

[in] SectionName

WMI セキュリティ情報を含む INF ファイル内のセクションの名前。 これは[DDinstall.WMI]の形式である必要があります。

[in] Flags

このパラメーターは次のように設定できます。

旗	意味
SCWMI_CLOBBER_SECURITY 0x0001	このフラグが設定されている場合にのみ、この関数に渡されるセキュリティ情報は、INF ファイル内の他の場所に設定されているセキュリティ情報をオーバーライドします。 このフラグが存在せず、INF ファイルにセキュリティ情報が存在しない場合は、セキュリティが設定されます。

戻り値

この関数は WINSETUPAPI BOOL を返します。

備考

以前のバージョンの SetupAPI では、INF ファイル内の WMI 情報はすべてのユーザーに公開され、レジストリ キーにバイナリ データを正しく書き込むことでのみアクセスを制限できました。 現在のバージョンでは、INF ファイルの DDInstall セクションによって提供される WMI セキュリティ情報を読み取って処理します。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	サポートされていません
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	setupapi.h
ライブラリ	Setupapi.lib
DLL	Setupapi.dll

関連項目

Functions

の概要

INF ファイルからセキュリティ記述子を指定する