IAudioSystemEffectsPropertyStore::OpenUserPropertyStore メソッド (mmdeviceapi.h)

オーディオシステム効果のユーザープロパティストアを開きます。

構文

HRESULT OpenUserPropertyStore(
  DWORD          stgmAccess,
  IPropertyStore **propStore
);

stgmAccess

ストレージアクセスモード。このパラメーターは、プロパティストアを読み取りモード、書き込みモード、または読み取り/書き込みモードで開くかどうかを指定します。このパラメーターを、次のいずれかの STGM 定数に設定します。

STGM_READ

STGM_WRITE

STGM_READWRITE

メソッドを使用すると、管理者として実行されているクライアントは、読み取り専用、書き込み専用、または読み取り/書き込みアクセス用にストアを開きます。管理者として実行されていないクライアントは、読み取り専用アクセスに制限されます。

propStore

ユーザープロパティストアを表す IPropertyStore へのポインターを受け取ります。

次のような HRESULT を返しますが、これらに限定されません。

値	説明
S_OK	Success
E_NOTFOUND	この呼び出しでは、存在しないプロパティストアを開こうとしています。「解説」を参照してください。
E_ACCESSDENIED	指定された stgmAccess 値の呼び出し元がアクセスを拒否されました

このメソッドは、コンテキストレジストリキーの下にある既存のプロパティストアのみを開きます。関連付けられている INF ファイルに新しいキーが存在しない場合、新しいキーは作成されません。まだ存在しないプロパティストアにアクセスしようとすると、E_NOTFOUND エラーが発生します。

オーディオドライバーに付属できるオーディオ処理オブジェクト (API) のWindows 11 API の詳細については、「オーディオ処理オブジェクトの API Windows 11」を参照してください。

要件	値
サポートされている最小のクライアント	Windows ビルド 22000
Header	mmdeviceapi.h