IMMDevice::OpenPropertyStore メソッド (mmdeviceapi.h)

  • [アーティクル]

OpenPropertyStore メソッドは、デバイスのプロパティ ストアへのインターフェイスを取得します。

構文

HRESULT OpenPropertyStore(
  [in]  DWORD          stgmAccess,
  [out] IPropertyStore **ppProperties
);

パラメーター

[in] stgmAccess

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

STGM_READ

STGM_WRITE

STGM_READWRITE

メソッドを使用すると、管理者として実行されているクライアントは、読み取り専用、書き込み専用、または読み取り/書き込みアクセス用にストアを開きます。 管理者として実行されていないクライアントは、読み取り専用アクセスに制限されます。 STGM 定数の詳細については、Windows SDK のドキュメントを参照してください。

[out] ppProperties

メソッドがデバイスのプロパティ ストアの IPropertyStore インターフェイスのアドレスを書き込むポインター変数へのポインター。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったインターフェイスを解放する必要があります。 OpenPropertyStore 呼び出しが失敗した場合、*ppProperties は NULL です。 IPropertyStore の詳細については、Windows SDK のドキュメントを参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_INVALIDARG
 パラメーター stgmAccess は有効なアクセス モードではありません。
E_POINTER
 パラメーター ppProperties が NULL です。
E_OUTOFMEMORY
 メモリが不足しています。

解説

一般に、デバイスのプロパティ ストアのプロパティは、管理、システム、またはサービスの機能を実行しないクライアントに対して読み取り専用です。

OpenPropertyStore メソッドを呼び出すコード例については、次のトピックを参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmdeviceapi.h

関連項目

IMMDevice インターフェイス