RegLoadMUIStringW

指定したキーとサブキーから指定した文字列をロードする。(Unicode)

RegLoadMUIStringW hKey, pszValue, pszOutBuf, cbOutBuf, pcbData, Flags, pszDirectory

hKey : [intptr] 開かれているレジストリキーへのハンドル。キーは KEY_QUERY_VALUE アクセス権で開かれている必要がある。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。このハンドルは RegCreateKeyEx または RegOpenKeyEx 関数が返す。以下の定義済みキーのいずれかを指定することもできる: HKEY_CLASSES_ROOT HKEY_CURRENT_CONFIG HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS
pszValue : [wstr] レジストリ値の名前。
pszOutBuf : [wstr] 文字列を受け取るバッファへのポインタ。次の形式の文字列は特別に処理される: @[path]\dllname,-strID 識別子 strID の文字列が dllname からロードされる。path は省略可能。pszDirectory パラメータが NULL でない場合、ディレクトリはレジストリデータで指定されたパスの前に付加される。dllname には展開される環境変数を含めることができる。
cbOutBuf : [int] pszOutBuf バッファのサイズ（バイト単位）。
pcbData : [var] pszOutBuf バッファにコピーされたデータのサイズ（バイト単位）を受け取る変数へのポインタ。バッファがデータを保持するには小さすぎる場合、関数は ERROR_MORE_DATA を返し、pcbData が指す変数に必要なバッファサイズを格納する。この場合、バッファの内容は未定義となる。
Flags : [int] このパラメータは 0 または次の値にできる。
pszDirectory : [wstr] ディレクトリパス。

(プラグイン / モジュール : advapi32.dll)

解説

指定したキーとサブキーから指定した文字列をロードする。(Unicode)

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値はシステムエラーコードとなる。pcbData
バッファが文字列を受け取るには小さすぎる場合、関数は ERROR_MORE_DATA を返す。この関数の ANSI 版は
ERROR_CALL_NOT_IMPLEMENTED を返す。

[備考]
RegLoadMUIString 関数は Unicode でのみサポートされている。この関数の Unicode 版 (W) と ANSI
版 (A) の両方が宣言されているが、RegLoadMUIStringA 関数は ERROR_CALL_NOT_IMPLEMENTED
を返す。アプリケーションは明示的に RegLoadMUIStringW を呼び出すか、プラットフォーム呼び出し (PInvoke)
で文字セットとして Unicode を指定すべきである。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT
を 0x0600 以降に定義する。詳細は Windows ヘッダの使用を参照のこと。
> [!NOTE] > winreg.h ヘッダは RegLoadMUIString をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報