次の方法で共有

RegLoadMUIStringW 関数 (winreg.h)

  • [アーティクル]

指定したキーとサブキーから指定した文字列を読み込みます。

構文

LSTATUS RegLoadMUIStringW(
  [in]            HKEY    hKey,
  [in, optional]  LPCWSTR pszValue,
  [out, optional] LPWSTR  pszOutBuf,
  [in]            DWORD   cbOutBuf,
  [out, optional] LPDWORD pcbData,
  [in]            DWORD   Flags,
  [in, optional]  LPCWSTR pszDirectory
);

パラメーター

[in] hKey

開いているレジストリ キーへのハンドル。 キーは、KEY_QUERY_VALUEアクセス権で開かれている必要があります。 詳細については、「レジストリ キーのセキュリティとアクセス権のを する」を参照してください。

このハンドルは、RegCreateKeyEx または RegOpenKeyEx 関数 返されます。 また、次のいずれかの定義済みキー することもできます。

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

[in, optional] pszValue

レジストリ値の名前。

[out, optional] pszOutBuf

文字列を受け取るバッファーへのポインター。

次の形式の文字列は、特別な処理を受け取ります。

@[パス]\dllname,-strID

識別子 strID を持つ文字列は、dllname読み込まれます。パス は省略可能です。 pszDirectory パラメーターが NULLされていない場合、ディレクトリはレジストリ データで指定されたパスの前に付加されます。 dllname 展開する環境変数を含めることができます。

[in] cbOutBuf

pszOutBuf バッファーのサイズ (バイト単位)。

[out, optional] pcbData

pszOutBuf バッファーにコピーされたデータのサイズをバイト単位で受け取る変数へのポインター。

バッファーがデータを保持するのに十分な大きさでない場合、関数はERROR_MORE_DATAを返し、pcbDataが指す変数に必要なバッファー サイズを格納します。 この場合、バッファーの内容は未定義です。

[in] Flags

このパラメーターには、0 または次の値を指定できます。

価値 意味
REG_MUI_STRING_TRUNCATE
0x00000001
 この文字列は、pszOutBuf バッファーの使用可能なサイズに合わせて切り捨てられます。 このフラグを指定する場合は、pcbData を NULLする必要があります。

[in, optional] pszDirectory

ディレクトリ パス。

戻り値

関数が成功した場合、戻り値は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 ヘッダーの使用」を参照してください。

手記

winreg.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RegLoadMUIString を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winreg.h (Windows.h を含む)
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

レジストリ関数 を する