ACCESSRESOURCE |
Ressource d'accès |
| Borland Pascal |
WINPROCS (Windows, Mode protégé DOS) |
Syntaxe
|
Function AccessResource(Instance,ResInfo:THandle):Integer;
|
Paramètres
| Nom |
Description |
| Instance |
Ce paramètre permet d'indiquer l'identificateur de l'instance du module dont le fichier exécutable contient la ressource. |
| ResInfo |
Ce paramètre permet d'indiquer l'identificateur de la ressource souhaitée. Ce handle doit être créé à l'aide de la fonction FindResource. |
Retour
| Valeur |
Description |
| -1 |
Cette valeur permet d'indiquer un échec. |
| 0 ou supérieur |
Ces valeurs renvoient le descripteur du fichier de ressources si la fonction réussit. |
Description
Cette fonction permet d'ouvrir un fichier exécutable spécifié et de déplacer le pointeur de fichier au début de la ressource spécifié.
Remarques
- La fonction AccessResource fournit un descripteur de fichier MS-DOS pouvant être utilisé dans les appels de lecture de fichier suivants pour
charger la ressource. Le fichier est ouvert en lecture seulement.
- Les applications utilisant cette fonction doivent fermer le fichier de ressources en appelant la fonction _lclose après avoir lu la ressource.
La fonction AccessResource peut épuiser les descripteurs de fichiers MS-DOS disponibles et provoquer des erreurs si le fichier ouvert n'est pas fermé
après l'accès à la ressource.
- En général, les fonctions LoadResource et LockResource sont préférées. Ces fonctions accéderont plus rapidement à la ressource si plusieurs ressources
sont lues, car Windows maintient un cache de descripteur de fichier pour accéder aux fichiers exécutables. Cependant, chaque appel à AccessResource nécessite
l'ouverture d'un nouveau descripteur de fichier vers le fichier exécutable.
- Vous ne devez pas utiliser AccessResource pour accéder aux fichiers exécutables installés dans la ROM sur un système basé sur ROM, car aucun fichier
disque n'est associé au fichier exécutable ; dans ce cas, un descripteur de fichier ne peut pas être retourné.
Dernière mise à jour : Mardi, le 25 Janvier 2022
