Fonction ORQueryInfoKey
Récupère des informations sur la clé de Registre spécifiée dans une ruche de Registre hors connexion.
Syntaxe
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
);
Paramètres
-
Handle [in]
-
Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.
-
lpClass [out, facultatif]
-
Pointeur vers une mémoire tampon qui reçoit la classe de clé. Ce paramètre peut être NULL.
-
lpcClass [in, out, optional]
-
Pointeur vers une variable qui spécifie la taille de la mémoire tampon vers laquelle pointe le paramètre lpClass , en caractères.
La taille doit inclure le caractère null de fin. Lorsque la fonction retourne, cette variable contient la taille de la chaîne de classe stockée dans la mémoire tampon. Le nombre retourné n’inclut pas le caractère null de fin. Si la mémoire tampon n’est pas assez grande, la fonction retourne ERROR_MORE_DATA et la variable contient la taille de la chaîne, en caractères, sans compter le caractère null de fin.
Si lpClass a la valeur NULL, lpcClass peut être NULL.
Si le paramètre lpClass est une adresse valide, mais que le paramètre lpcClass ne l’est pas (par exemple, si le paramètre lpcClass a la valeur NULL), la fonction retourne ERROR_INVALID_PARAMETER.
-
lpcSubKeys [out, facultatif]
-
Pointeur vers une variable qui reçoit le nombre de sous-clés contenues par la clé spécifiée. Ce paramètre peut être NULL.
-
lpcMaxSubKeyLen [out, facultatif]
-
Pointeur vers une variable qui reçoit la taille de la sous-clé de la clé avec le nom le plus long, en caractères Unicode, sans inclure le caractère null de fin. Ce paramètre peut être NULL.
-
lpcMaxClassLen [out, facultatif]
-
Pointeur vers une variable qui reçoit la taille de la chaîne la plus longue qui spécifie une classe de sous-clé, en caractères Unicode. Le nombre retourné n’inclut pas le caractère null de fin. Ce paramètre peut être NULL.
-
lpcValues [out, facultatif]
-
Pointeur vers une variable qui reçoit le nombre de valeurs associées à la clé. Ce paramètre peut être NULL.
-
lpcMaxValueNameLen [out, facultatif]
-
Pointeur vers une variable qui reçoit la taille du nom de valeur la plus longue de la clé, en caractères Unicode. La taille n’inclut pas le caractère null de fin. Ce paramètre peut être NULL.
-
lpcMaxValueLen [out, facultatif]
-
Pointeur vers une variable qui reçoit la taille du composant de données le plus long parmi les valeurs de la clé, en octets. Ce paramètre peut être NULL.
-
lpcbSecurityDescriptor [out, facultatif]
-
Pointeur vers une variable qui reçoit la taille du descripteur de sécurité de la clé, en octets. Ce paramètre peut être NULL.
-
lpftLastWriteTime [out, facultatif]
-
Pointeur vers une structure FILETIME qui reçoit l’heure de la dernière écriture. Ce paramètre peut être NULL.
La fonction définit les membres de la structure FILETIME pour indiquer l’heure de la dernière modification de la clé ou de l’une de ses entrées de valeur.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.
Si la mémoire tampon lpClass est trop petite pour recevoir le nom de la classe, la fonction retourne ERROR_MORE_DATA.
Spécifications
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Bibliothèque du Registre windows hors connexion version 1.0 ou ultérieure |
| En-tête |
|
| DLL |
|
Voir aussi