Table RegLocator
La table RegLocator contient les informations nécessaires pour rechercher un fichier ou un répertoire à l’aide du registre, ou pour rechercher une entrée de Registre particulière. Cette table présente les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Signature_ | Identificateur | O | N |
| Root | Integer | N | N |
| Clé | RegPath | N | N |
| Nom | Formatted | N | O |
| Type | Integer | N | O |
Colonnes
-
Signature_
-
La valeur dans le champ Signature_ représente une signature unique qui est une clé externe dans la colonne 1 de la table Signature. Si cette signature est présente dans la table Signature, la recherche concerne un fichier. Si la signature est absente de la table Signature et que la valeur de la colonne Type est msidbLocatorTypeRawValue, la recherche concerne le nom de clé de registre spécifique pointé par la table RegLocator. Sinon, la recherche correspond à un répertoire pointé vers la table RegLocator.
-
Racine
-
Clé racine prédéfinie pour la valeur de Registre.
Constante Valeur hexadécimale Decimal Clé racine msidbRegistryRootClassesRoot 0x000 0 HKEY_CLASSES_ROOT msidbRegistryRootCurrentUser 0x001 1 HKEY_CURRENT_USER msidbRegistryRootLocalMachine 0x002 2 HKEY_LOCAL_MACHINE msidbRegistryRootUsers 0x003 3 HKEY_USERS -
Clé
-
Clé de la valeur de Registre.
-
Nom
-
Nom de la valeur de Registre. Si cette valeur est Null, la valeur de la valeur sans nom de la clé ou la valeur par défaut, le cas échéant, est récupérée.
-
Type
-
Valeur qui détermine si la valeur de Registre est un nom de fichier, un emplacement de répertoire ou une valeur de Registre brute.
Le tableau suivant répertorie les valeurs valides. Définissez l’une des trois premières valeurs et msidbLocatorType64bit si nécessaire. Si l’entrée de ce champ est absente, Type est défini sur 1.
Constante Valeur hexadécimale Decimal Description msidbLocatorTypeDirectory 0x000 0 Le chemin d’accès à la clé est un répertoire. msidbLocatorTypeFileName 0x001 1 Le chemin d’accès à la clé est un nom de fichier. msidbLocatorTypeRawValue 0x002 2 Le chemin de la clé est une valeur de Registre. msidbLocatorType64bit 0x010 16 Définissez ce bit pour que le programme d’installation effectue une recherche dans la partie 64 bits du Registre. Ne définissez pas ce bit pour que le programme d’installation effectue une recherche dans la partie 32 bits du Registre.
Notes
Notez que si la valeur du champ Type est msidbLocatorTypeRawValue, le programme d’installation définit la valeur de la propriété spécifiée dans le champ Propriété de la table AppSearch sur la valeur de Registre. Le programme d’installation ajoute un préfixe à la valeur de Registre qui identifie le type de valeur de Registre. Pour plus d’informations sur les types de valeurs de Registre, consultez Types de valeurs de Registre.
| Type de registre | Préfixe ajouté par le programme d’installation |
|---|---|
| REG_SZ | Aucun, mais si le premier caractère de la valeur de Registre est #, le programme d’installation échappe le caractère en préfixant un autre #. |
| DWORD | « # » éventuellement suivi de '+' ou '-' |
| REG_EXPAND_SZ | "#%" |
| REG_MULTI_SZ | Null. Le programme d’installation définit la propriété sur une valeur commençant par une valeur Null et se terminant par une valeur Null. |
| REG_BINARY | « #x » En cas de REG_BINARY, le programme d’installation convertit et enregistre chaque chiffre hexadécimal (quartet) sous la forme d’un caractère ASCII précédé de « #x ». |
En règle générale, les colonnes de cette table ne sont pas localisées. Si un auteur décide de rechercher des produits dans plusieurs langues, une entrée distincte doit être incluse dans la table pour chaque langue.
Notez qu’il n’est pas possible d’utiliser la table RegLocator pour vérifier uniquement la présence de la clé. Toutefois, vous pouvez rechercher la valeur par défaut d’une clé et récupérer sa valeur si elle n’est pas vide.
Consultez Recherche d’applications, de fichiers, d’entrées de Registre ou d’entrées de fichier .ini existantes.
Validation