<Return[S]><Top>

SHQueryInfoKey

Declare Function Api_SHQueryInfoKey& Lib "Shlwapi" Alias "SHQueryInfoKeyA" (ByVal hkey&, pcSubKeys&, pcchMaxSubKeyLen&, pcValues&, pcchMaxValueNameLen&)

Declare Function SHQueryInfoKey Lib "shlwapi" Alias "SHQueryInfoKeyA" (ByVal hkey As Long, ByRef pcSubKeys As Long, ByRef pcchMaxSubKeyLen As Long, ByRef pcValues As Long, ByRef pcchMaxValueNameLen As Long) As Long

レジストリキーに関する情報を取得する。

パラメータ
hKey
    現在開いているキーを指定する。代わりに、あらかじめ定義されている次の予約済みハンドルのいずれかを指定することもできる。
    HKEY_CLASSES_ROOT
    HKEY_CURRENT_CONFIG
    HKEY_CURRENT_USER
    HKEY_LOCAL_MACHINE
    HKEY_USERS
    Windows NT/2000:HKEY_PERFORMANCE_DATA も指定できる。
    Windows 95/98:HKEY_DYN_DATA も指定できる。
pcSubKeys
    1 個の変数へのポインタを指定する。関数から制御が返ると、この変数に、指定されたキーに所属しているサブキーの数が格納される。

    このパラメータで、NULL を指定することもできる。
pcchMaxSubKeyLen
    1 個の変数へのポインタを指定する。関数から制御が返ると、この変数に、指定されたキーに所属するサブキーのうち、最も長い名前を持

    つサブキーの名前の長さが TCHAR 単位で格納される。このパラメータで、NULL を指定することもできる。
    Windows NT/2000:この変数に格納される長さには、終端の NULL は含まれない。
    Windows 95/98:この変数に格納される長さには、終端の NULL が含まれる。
pcValues
    1 個の変数へのポインタを指定する。関数から制御が返ると、この変数に、指定されたキーに所属しているレジストリエントリの数が格納さ

    れる。このパラメータで、NULL を指定することもできる。
pcchMaxValueNameLen
    キーの値の最長の名前の長さを文字数で取得する 1 個の変数へのポインタを指定する。関数から制御が返ると、この変数に、指定された

    キーに所属するレジストリエントリのうち、最長の名前を持つレジストリエントリの名前の長さが格納される(終端の NULL を除く)。このパ

    ラメータで、NULL を指定することもできる。

戻り値
    関数が成功すると、ERROR_SUCCESS が返る。
    関数が失敗すると、Winerror.h ヘッダーファイル内で定義されている、0 以外のエラーコードが返る。

    FORMAT_MESSAGE_FROM_SYSTEM フラグを指定して FormatMessage 関数を呼び出すと、エラーの一般的な説明を取得できる。