LoadTypeLibWithResolver, fonction
Mise à jour : novembre 2007
Charge une bibliothèque de types et utilise l'interface ITypeLibResolver fournie pour résoudre toutes bibliothèques de types référencées en interne.
HRESULT LoadTypeLibWithResolver(
[in] LPCOLESTR szFile,
[in] REGKIND regkind,
[in] ITypeLibResolver *pTlbResolver,
[out] ITypeLib **pptlib);
Paramètres
szFile
[in] Chemin du fichier de la bibliothèque de types.regkind
[in] Indicateur d'énumération REGKIND qui contrôle comment la bibliothèque de types est enregistrée. Les valeurs possibles sont les suivantes :REGKIND_DEFAULT: Utilisez le comportement d'inscription par défaut.
REGKIND_REGISTER: Enregistrez cette bibliothèque de types.
REGKIND_NONE: N'enregistrez pas cette bibliothèque de types.
pTlbResolver
[in] Pointeur vers l'implémentation de l' interface ITypeLibResolver.pptlib
[out] Référence à la bibliothèque de types chargée.
Valeur de retour
Un hôte peut affecter les valeurs répertoriées dans le tableau suivant.
Valeur de retour |
Signification |
---|---|
S_OK |
Succès. |
E_OUTOFMEMORY |
Mémoire insuffisante. |
E_POINTER |
Un ou plusieurs pointeurs ne sont pas valides. |
E_INVALIDARG |
Un ou plusieurs arguments ne sont pas valides. |
TYPE_E_IOERROR |
La fonction n'est pas en mesure d'écrire dans le fichier. |
TYPE_E_REGISTRYACCESS |
La base de données d'inscription de système n'a pas pu être ouverte. |
TYPE_E_INVALIDSTATE |
La bibliothèque spécifiée n'a pas pu être ouverte. |
TYPE_E_CANTLOADLIBRARY |
Une bibliothèque de types ou une DLL n'a pas pu être chargée. |
Notes
Type Library Exporter, outil (Tlbexp.exe) appelle la fonction LoadTypeLibWithResolver pendant le processus de conversion assembly à type de bibliothèque.
Cette fonction charge la bibliothèque de types spécifiée avec accès minime au Registre. La fonction, ensuite, examine la bibliothèque de types à la recherche des bibliothèques de types de références internes, chacune devant être chargées et ajoutées à la bibliothèque de type parent.
Avant qu'une bibliothèque de types référencée puisse être chargée, son chemin d'accès de fichier de référence doit être résolu. Cela est accompli à travers la méthode ResolveTypeLib fournie par l' interface ITypeLibResolver, passée dans le paramètre pTlbResolver.
Lorsque le chemin d'accès de fichier complet de la bibliothèque de types référencée est connu, la fonction LoadTypeLibWithResolver se charge et ajoute la bibliothèque de types référencée à la bibliothèque de type parent, en créant une bibliothèque de types principale combinée.
Après les résolutions de fonction et chargement des bibliothèques de types référencées en interne, une référence est retournée à la bibliothèque de types résolue principale dans le paramètre pptlib.
La fonction LoadTypeLibWithResolver est généralement appelée par le Type Library Exporter, outil (Tlbexp.exe), qui fournit sa propre implémentation interne d'interface ITypeLibResolver dans le paramètre pTlbResolver.
Si vous appelez LoadTypeLibWithResolver directement, vous devez fournir votre propre implémentation d'interface ITypeLibResolver.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : TlbRef.h
Bibliothèque : TlbRef.lib
Version .NET Framework : 3.5, 3.0, 2.0
Voir aussi
Référence
Autres ressources
Fonctions d'assistance de Tlbexp (Référence des API non managées)