Win32 API 日本語リファレンス
ホーム › Media.WindowsMediaFormat › IWMProfileManagerLanguage

IWMProfileManagerLanguage

COM
📘 Microsoft Learn (日本語) · English
IIDba4dcc78-7ee0-4ab8-b27a-dbce8bc51454継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMProfileManagerLanguage インターフェースは、プロファイルマネージャーによって解析されるシステムプロファイルの言語を制御します。IWMProfileManagerLanguage インターフェースは、すべてのプロファイルマネージャーオブジェクトに対して存在します。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetUserLanguageID(WORD* wLangID)

GetUserLanguageID メソッドは、プロファイルマネージャーオブジェクトによって読み込まれたシステムプロファイルの言語識別子を取得します。

wLangIDWORD*inoutプロファイルマネージャーに設定されている言語の言語識別子 (LANGID) を受け取る WORD へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表の値が含まれますが、これらに限定されません。

リターンコード 説明
S_OK
 メソッドは成功しました。

解説(Remarks)

既定の言語は米国英語 (0x409) です。

vtbl 4 HRESULT SetUserLanguageID(WORD wLangID)

SetUserLanguageID メソッドは、プロファイルマネージャーオブジェクトによって解析されるシステムプロファイルの言語を設定します。

wLangIDWORDin使用する言語の言語識別子 (LANGID) を格納する WORD。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表の値が含まれますが、これらに限定されません。

リターンコード 説明
S_OK
 メソッドは成功しました。
NS_E_NOMATCHING_ELEMENT
 指定された LANGID は、ローカライズされたシステムプロファイルのセットでサポートされていない地域を表しています。

解説(Remarks)

英語 – 米国 (0x0409) が既定の言語です。正しい .prx ファイルをシステムルートディレクトリに移動していない場合、このメソッドは米国英語以外のすべての言語に対しても NS_E_MOMATCHING_ELEMENT を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IWMProfileManagerLanguage "{BA4DCC78-7EE0-4AB8-B27A-DBCE8BC51454}"
#usecom global IWMProfileManagerLanguage IID_IWMProfileManagerLanguage "{}"
#comfunc global IWMProfileManagerLanguage_GetUserLanguageID  3 var
#comfunc global IWMProfileManagerLanguage_SetUserLanguageID  4 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。