Função ORQueryInfoKey
Recupera informações sobre a chave do Registro especificada em um hive de registro offline.
Sintaxe
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
);
Parâmetros
-
Manipular [in]
-
Um identificador para uma chave do Registro aberta em um hive de registro offline.
-
lpClass [out, opcional]
-
Um ponteiro para um buffer que recebe a classe de chave. Este parâmetro pode ser NULL.
-
lpcClass [in, out, opcional]
-
Um ponteiro para uma variável que especifica o tamanho do buffer apontado pelo parâmetro lpClass , em caracteres.
O tamanho deve incluir o caractere nulo de terminação. Quando a função retorna, essa variável contém o tamanho da cadeia de caracteres de classe armazenada no buffer. A contagem retornada não inclui o caractere nulo de terminação. Se o buffer não for grande o suficiente, a função retornará ERROR_MORE_DATA e a variável conterá o tamanho da cadeia de caracteres, em caracteres, sem contar o caractere nulo de terminação.
Se lpClass for NULL, lpcClass poderá ser NULL.
Se o parâmetro lpClass for um endereço válido, mas o parâmetro lpcClass não for (por exemplo, se o parâmetro lpcClass for NULL), a função retornará ERROR_INVALID_PARAMETER.
-
lpcSubKeys [out, opcional]
-
Um ponteiro para uma variável que recebe o número de subchaves contidas pela chave especificada. Este parâmetro pode ser NULL.
-
lpcMaxSubKeyLen [out, opcional]
-
Um ponteiro para uma variável que recebe o tamanho da subchave da chave com o nome mais longo, em caracteres Unicode, sem incluir o caractere nulo de terminação. Este parâmetro pode ser NULL.
-
lpcMaxClassLen [out, opcional]
-
Um ponteiro para uma variável que recebe o tamanho da cadeia de caracteres mais longa que especifica uma classe de subchave, em caracteres Unicode. A contagem retornada não inclui o caractere nulo de terminação. Este parâmetro pode ser NULL.
-
lpcValues [out, opcional]
-
Um ponteiro para uma variável que recebe o número de valores associados à chave. Este parâmetro pode ser NULL.
-
lpcMaxValueNameLen [out, opcional]
-
Um ponteiro para uma variável que recebe o tamanho do nome de valor mais longo da chave, em caracteres Unicode. O tamanho não inclui o caractere nulo de terminação. Este parâmetro pode ser NULL.
-
lpcMaxValueLen [out, opcional]
-
Um ponteiro para uma variável que recebe o tamanho do componente de dados mais longo entre os valores da chave, em bytes. Este parâmetro pode ser NULL.
-
lpcbSecurityDescriptor [out, opcional]
-
Um ponteiro para uma variável que recebe o tamanho do descritor de segurança da chave, em bytes. Este parâmetro pode ser NULL.
-
lpftLastWriteTime [out, opcional]
-
Um ponteiro para uma estrutura FILETIME que recebe a última hora de gravação. Este parâmetro pode ser NULL.
A função define os membros da estrutura FILETIME para indicar a última vez que a chave ou qualquer uma de suas entradas de valor é modificada.
Valor retornado
Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor de retorno será o código de erro diferente de zero definido em Winerror.h. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.
Se o buffer lpClass for muito pequeno para receber o nome da classe , a função retornará ERROR_MORE_DATA.
Requisitos
| Requisito | Valor |
|---|---|
| Redistribuível |
Biblioteca do Registro Offline do Windows versão 1.0 ou posterior |
| Cabeçalho |
|
| DLL |
|
Confira também