SetupConfigureWmiFromInfSectionW 関数 (setupapi.h)

  • [アーティクル]

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

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

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

構文

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionW(
  [in] HINF   InfHandle,
  [in] PCWSTR 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 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー setupapi.h
Library Setupapi.lib
[DLL] Setupapi.dll

関連項目

関数

概要

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