Clé AppID
Regroupe les options de configuration d’un ou de plusieurs objets DCOM dans un emplacement centralisé dans le Registre. Les objets DCOM hébergés par le même exécutable sont regroupés dans un Seul AppID pour simplifier la gestion des paramètres de configuration et de sécurité courants.
Clé de Registre
\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\AppID{AppID_GUID}
| Valeur de Registre | Description |
|---|---|
| AccessPermission | Décrit la liste de Access Control (ACL) des principaux qui peuvent accéder aux instances de cette classe. Cette liste de contrôle d’accès est utilisée uniquement par les applications qui n’appellent pas CoInitializeSecurity. |
| ActivateAtStorage | Configure le client pour instancier des objets sur le même ordinateur que l’état persistant qu’il utilise ou à partir duquel ils sont initialisés. |
| Appid | Identifie le GUID AppID qui correspond au fichier exécutable nommé. |
| AppIDFlags | Configure la façon dont un serveur COM configuré pour s’exécuter en tant qu'« utilisateur interactif » sera lancé ou lié par un client dans un bureau autre que celui par défaut. |
| AuthenticationLevel | Définit le niveau d’authentification pour les applications qui n’appellent pas CoInitializeSecurity ou pour les applications qui appellent CoInitializeSecurity et spécifient un AppID. |
| DllSurrogate | Permet aux serveurs DLL de s’exécuter dans un processus de substitution. Si une chaîne vide est spécifiée, le substitut fourni par le système est utilisé ; sinon, la valeur spécifie le chemin du substitut à utiliser. |
| DllSurrogateExecutable | Permet aux serveurs DLL de s’exécuter dans un processus de substitution personnalisé, conjointement avec la valeur de Registre DllSurrogate . |
| Points de terminaison | Configure une application COM pour utiliser un numéro de port TCP spécifié pour les communications DCOM. |
| LaunchPermission | Décrit la liste de Access Control (ACL) des principaux qui peuvent démarrer de nouveaux serveurs pour cette classe. |
| LoadUserSettings | Détermine si COM chargera le profil utilisateur pour les serveurs COM s’exécutant en tant qu’identité d’application utilisateur de lancement. |
| LocalService | Installe un objet en tant qu’application de service. |
| PreferredServerBitness | Définit l’architecture préférée, 32 bits ou 64 bits, pour ce serveur COM. |
| RemoteServerName | Configure le client pour demander l’exécution de l’objet sur un ordinateur particulier chaque fois qu’une fonction d’activation est appelée pour laquelle aucune structure COSERVERINFO n’est spécifiée. |
| ROTFlags | Contrôle l’inscription d’un serveur COM dans la table d’objets en cours d’exécution (ROT). |
| RunAs | Configure une classe pour qu’elle s’exécute sous un compte d’utilisateur spécifique lorsqu’elle est activée par un client distant sans être écrite en tant qu’application de service. |
| ServiceParameters | Spécifie les paramètres de ligne de commande à passer à un objet installé pour une utilisation par COM via la valeur de Registre LocalService . |
| SRPTrustLevel | Définit le niveau d’approbation de la stratégie de restriction logicielle (SRP) pour les applications. |
Notes
Les ID d’application sont mappés à des exécutables et des classes à l’aide de deux mécanismes différents :
- Utilisation d’un identificateur global unique (GUID) 128 bits qui identifie la clé AppID . Une classe indique son AppID correspondant sous la clé CLSID dans une valeur nommée « AppID ». Ce mappage est utilisé pendant l’activation.
- Utilisation d’une valeur nommée qui indique un nom exécutable (par exemple, « MYOLDAPP.EXE »). Cette valeur nommée est de type REG_SZ et contient la représentation sous forme de chaîne de l’AppID associé à l’exécutable. Ce mappage est utilisé pour obtenir les autorisations d’accès et le niveau d’authentification par défaut.
La cléHKEY_LOCAL_MACHINE\SOFTWARE\Classescorrespond à la clé HKEY_CLASSES_ROOT, qui a été conservée pour assurer la compatibilité avec les versions antérieures de COM.
Pour les serveurs COM, le mappage est généralement généré et écrit dans le Registre pendant le processus d’inscription ou lors de l’exécution de dcomcnfg.exe. Toutefois, les clients COM qui souhaitent définir la sécurité à l’aide de la clé AppID doivent créer des clés de Registre appropriées et spécifier le mappage requis en appelant les fonctions de Registre ou en utilisant Regedit.exe. Ensuite, des valeurs telles que AccessPermission ou AuthenticationLevel peuvent être définies pour le client. Par exemple, supposons que le nom de votre exécutable pour votre processus client soit « YourClient.exe » et que vous souhaitez définir le niveau d’authentification sur « None ». Vous utilisez Guidgen.exe ou Uuidgen.exe pour créer le GUID correspondant à l’AppID de votre exécutable. Ensuite, vous devez définir des valeurs dans le Registre comme indiqué dans l’exemple suivant, où 00000001 représente un niveau d’authentification « None » :
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\AppID
{MyGuid}
AuthenticationLevel = 00000001
MyClient.exe
AppID = {MyGUID}