PrfQueryProfileData |
Profile : Requête de profile de données |
|---|---|
| PMMERGE.DLL, PMSHAPI.DLL | os2.h |
Syntaxe
| BOOL PrfQueryProfileData( HINI hini, PSZ pszAppName, PSZ pszKeyWord, PVOID pBuffer, PULONG pulBufSize ); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| hini | Ce paramètre permet d'indiquer le Handle du profile à rechercher dans les données. Les valeurs peuvent être les suivantes : | ||
| Constante | Description | ||
| HINI_PROFILE | Cette constante permet d'indiquer qu'il faut rechercher dans les profiles USER ou SYSTEM. | ||
| HINI_USERPROFILE | Cette constante permet d'indiquer qu'il faut rechercher seulement dans le profile USER. | ||
| HINI_SYSTEMPROFILE | Cette constante permet d'indiquer qu'il faut rechercher seulement dans le profile SYSTEM. | ||
| une variable | Ces valeurs permettent d'indiquer une recherche de profile programme définit par l'utilisateur. | ||
| pszAppName | Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères ASCIZ donnant le nom de l'application à rechercher dans le profile. Les paramètres peuvent être : | ||
| Constante | Description | ||
| NULL | Cette constante permet d'indiquer que le paramètre pBuffer retournera la liste de tous les noms d'application dans ce profile. | ||
| une variable | Ces valeurs permettent d'indiquer un nom d'application à rechercher. | ||
| pszKeyWord | Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères ASCIZ donnant le nom du mot clef à rechercher dans le nom d'application spécifié. Les paramètres peuvent être : | ||
| Constante | Description | ||
| NULL | Cette constante permet d'indiquer que le paramètre pBuffer retournera la liste de tous les mots clefs associé avec le profile spécifié. | ||
| une variable | Ces valeurs permettent d'indiquer un mot clef à rechercher. | ||
| pBuffer | Ce paramètre permet d'indiquer un pointeur vers tampon PrfQueryProfileData() allant être remplis avec le retour des données. | ||
| pulBufSize | Ce paramètre permet d'indiquer un pointeur vers une valeur long naturel de la taille du pBuffer en octets. | ||
Retour
| Valeur | Description |
|---|---|
| FALSE | Cette valeur permet d'indiquer qu'une erreur s'est produite, dans ce cas consulter la fonction WinGetLastError(). |
| TRUE | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
Description
Cette fonction permet de terminer un profile précédemment créer par la fonction PrfOpenProfile.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_WINSHELLDATA
- #include "os2.h"
- #include "string.h"
- #include "stdio.h"
-
- void main(void) {
- struct {
- USHORT data1;
- UCHAR data2[20];
- } mydata;
- ULONG size = sizeof(mydata);
- mydata.data1 = 0;
- strcpy(mydata.data2, "MADONNEE");
- if(!PrfQueryProfileData(HINI_PROFILE, "MonProg", "AJUSTEMENTS", &mydata, &size)) {
- printf("Une erreur s'est produite");
- }
- }
Voir également
Langage de programmation - C pour OS/2 - PrfOpenProfile
Langage de programmation - C pour OS/2 - PrfQueryProfileSize
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010