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

ICE03
ICE06
ICE46
ICE80