次の方法で共有

ORQueryInfoKey 関数

  • [アーティクル]

オフライン レジストリ ハイブ内の指定されたレジストリ キーに関する情報を取得します。

構文

DWORD ORQueryInfoKey(
  _In_        ORHKEY    Handle,
  _Out_opt_   PWSTR     lpClass,
  _Inout_opt_ PDWORD    lpcClass,
  _Out_opt_   PDWORD    lpcSubKeys,
  _Out_opt_   PDWORD    lpcMaxSubKeyLen,
  _Out_opt_   PDWORD    lpcMaxClassLen,
  _Out_opt_   PDWORD    lpcValues,
  _Out_opt_   PDWORD    lpcMaxValueNameLen,
  _Out_opt_   PDWORD    lpcMaxValueLen,
  _Out_opt_   PDWORD    lpcbSecurityDescriptor,
  _Out_opt_   PFILETIME lpftLastWriteTime
);

パラメーター

ハンドル [入力]

オフライン レジストリ ハイブで開いているレジストリ キーへのハンドル。

lpClass [out, optional]

キー クラスを受け取るバッファーへのポインター。 このパラメーターは、NULL でもかまいません。

lpcClass [in, out, optional]

lpClass パラメーターによって指されるバッファーのサイズを文字で指定する変数へのポインター。

サイズには、終端の null 文字を含める必要があります。 関数が戻るとき、この変数にはバッファーに格納されているクラス文字列のサイズが含まれます。 返されるカウントには、終端の null 文字は含まれません。 バッファーの大きさが十分でない場合、関数は ERROR_MORE_DATAを返し、変数には文字列のサイズが文字単位で格納され、終端の null 文字はカウントされません。

lpClass が NULL の場合、lpcClass は NULL にすることができます。

lpClass パラメーターが有効なアドレスで、lpcClass パラメーターが (たとえば、lpcClass パラメーターが NULL の場合) でない場合、関数はERROR_INVALID_PARAMETERを返します。

lpcSubKeys [out, optional]

指定したキーに含まれるサブキーの数を受け取る変数へのポインター。 このパラメーターは、NULL でもかまいません。

lpcMaxSubKeyLen [out, optional]

名前が最も長いキーのサブキーのサイズを Unicode 文字で受け取る変数へのポインター。終端の null 文字は含まれません。 このパラメーターは、NULL でもかまいません。

lpcMaxClassLen [out, optional]

サブキー クラスを指定する最長の文字列のサイズを Unicode 文字で受け取る変数へのポインター。 返されるカウントには、終端の null 文字は含まれません。 このパラメーターは、NULL でもかまいません。

lpcValues [out, optional]

キーに関連付けられている値の数を受け取る変数へのポインター。 このパラメーターは、NULL でもかまいません。

lpcMaxValueNameLen [out, optional]

キーの最長値名のサイズを Unicode 文字で受け取る変数へのポインター。 このサイズには、終端の null 文字は含まれません。 このパラメーターは、NULL でもかまいません。

lpcMaxValueLen [out, optional]

キーの値の中で最も長いデータ コンポーネントのサイズをバイト単位で受け取る変数へのポインター。 このパラメーターは、NULL でもかまいません。

lpcbSecurityDescriptor [out, optional]

キーのセキュリティ記述子のサイズをバイト単位で受け取る変数へのポインター。 このパラメーターは、NULL でもかまいません。

lpftLastWriteTime [out, optional]

最後の書き込み時刻を受け取る FILETIME 構造体へのポインター。 このパラメーターは、NULL でもかまいません。

この関数は、 FILETIME 構造体のメンバーを設定して、キーまたはその値エントリのいずれかが最後に変更されたことを示します。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は Winerror.h で定義されている 0 以外のエラー コードです。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。

lpClass バッファーが小さすぎてクラスの名前を受け取れなければ、関数は ERROR_MORE_DATAを返します。

必要条件

要件 値
再頒布可能パッケージ
 Windows オフライン レジストリ ライブラリ バージョン 1.0 以降
ヘッダー
Offreg.h
[DLL]
Offreg.dll

関連項目

FILETIME

ORCreateKey

OROpenKey

ORDeleteKey