=head1 NOM

Win32::Registry - accéder au Registre de Windows [obsolète, utilisez Win32::TieRegistry]

=head1 SYNOPSIS

    use Win32::Registry;
    my $tips;
    $::HKEY_LOCAL_MACHINE->Open("SOFTWARE\\Microsoft\\Windows"
                               ."\\CurrentVersion\\Explorer\\Tips", $tips)
        or die "Can't open tips: $^E";
    my ($type, $value);
    $tips->QueryValueEx("18", $type, $value) or die "No tip #18: $^E";
    print "Here's a tip: $value\n";

=head1 DESCRIPTION

Module obsolète, utilisez L<Win32::TieRegistry|Win32TieRegistry>

    NOTE: Ce module fournit une interface malcommode pour accéder au Registre
    de Windows, et n'est plus activement développé actuellement. Il est présent
    seulement pour assurer la compatibilité ascendante avec le vieux code qui
    l'utilise encore. Pour des méthodes d'accès au Registre plus puissantes et
    plus flexibles, utilisez Win32::TieRegistry.

Win32::Registry fournit une interface orienté objet au Registre de Windows.

Les objets "racine" du Registre suivants sont exportés dans l'espace de nom
principal main::.  Des clefs supplémentaires peuvent être ouvertes en appelant
les méthodes fournies sur l'un de ceux-ci.

    $HKEY_CLASSES_ROOT
    $HKEY_CURRENT_USER
    $HKEY_LOCAL_MACHINE
    $HKEY_USERS
    $HKEY_PERFORMANCE_DATA
    $HKEY_CURRENT_CONFIG
    $HKEY_DYN_DATA

=head2 Méthodes

Les méthodes suivantes sont disponibles.  Notez que les sous-clefs
peuvent être spécifiées comme un nom de chemin, les séparateurs étant des
backslashes (lesquels doivent être doublés si vous les placez entre des
guillemets doubles).

=over 8

=item Open

    $reg_obj->Open($sub_key_name, $sub_reg_obj);

Ouvre une sous-clef d'un objet Registre, en retournant le nouvel objet Registre
dans $sub_reg_obj.

=item Close

    $reg_obj->Close();

Ferme une clef de Registre ouverte.

=item Connect

    $reg_obj->Connect($node_name, $new_reg_obj);

Établit une connexion à un Registre distant sur le noeud du réseau spécifié par $node_name,
et retourne le nouvel objet Registre dans $new_reg_obj. Retourne faux en cas d'échec.

=item Create

    $reg_obj->Create($sub_key_name, $new_reg_obj);

Ouvre la sous-clef spécifiée par $sub_key_name, et retourne le nouvel objet
Registre dans $new_reg_obj.  Si la sous-clef spécifiée n'existe pas, elle
est crée.

=item SetValue

    $reg_obj->SetValue($sub_key_name, $type, $value);

Fixe la valeur par défaut de la sous-clef spécifiée par $sub_key_name.


=item SetValueEx

    $reg_obj->SetValueEx($value_name, $reserved, $type, $value);

Fixe la valeur pour le nom de valeur identifié par $value_name dans
la clef spécifiée par $reg_obj.

=item QueryValue

    $reg_obj->QueryValue($sub_key_name, $value);

Obtient la valeur par défaut de la sous-clef spécifiée par $sub_key_name.

=item QueryKey

    $reg_obj->QueryKey($classref, $number_of_subkeys, $number_of_values);

Obtient l'information sur une clef spécifiée par $reg_obj.

=item QueryValueEx

    $reg_obj->QueryValueEx($value_name, $type, $value);

Donne la valeur pour le nom de valeur identifié par $value_name dans
la clef spécifiée par $reg_obj.

=item GetKeys

    my @keys;
    $reg_obj->GetKeys(\@keys);

Remplit le tableau passé par référence avec les noms de toutes les clefs
de l'objet Registre $reg_obj.

=item GetValues

    my %values;
    $reg_obj->GetValues(\%values);

Remplit le hachage passé par référence avec les entrées de la forme

    $value_name => [ $value_name, $type, $data ]

pour chaque valeur de l'objet Registre $reg_obj.

=item DeleteKey

    $reg_obj->DeleteKey($sub_key_name);

Efface du Registre une sous-clef spécifiée par $sub_key_name.

=item DeleteValue

    $reg_obj->DeleteValue($value_name);

Efface du Registre une valeur identifiée par $value_name.

=item Save

    $reg_obj->Save($filename);

Sauve dans un fichier la ruche spécifiée par $reg_obj.

=item Load

    $reg_obj->Load($sub_key_name, $file_name);

Charge depuis un fichier la clef spécifiée par $sub_key_name.

=item UnLoad

    $reg_obj->Unload($sub_key_name);

Décharge une ruche du Registre.

=back

=head1 VERSION FRANÇAISE

Cette traduction française correspond à la version anglaise distribuée avec perl 5.8.0.
Pour en savoir plus concernant ces traductions, consultez http://www.enstimac.fr/Perl/ .

=head1 TRADUCTION EN FRANÇAIS

Jean-Louis Morel <jl_morel@bribes.org>

=cut