PrfQueryProfileSize |
Profile : Taille de la requête de profile |
---|---|
PMMERGE.DLL, PMSHAPI.DLL | os2.h |
Syntaxe
BOOL PrfQueryProfileSize( HINI hini, PSZ pszAppName, PSZ pszKeyWord, PULONG pulDataSize ); |
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 dans le profile USER. | ||
HINI_SYSTEMPROFILE | Cette constante permet d'indiquer qu'il faut rechercher 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 pulDataSize retournera le nombre d'octets nécessaire pour entreposer la liste de l'énumération 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 pulDataSize retournera le nombre d'octets nécessaire pour entreposer la liste de l'énumération de tous les mots clefs dans ce profile. | ||
une variable | Ces valeurs permettent d'indiquer un mot clef à rechercher. | ||
pulDataSize | Ce paramètre permet d'indiquer un pointeur vers une valeur long naturel entreposant le résultat du nombre d'octets requis pour entreposé les données associés avec une paire d'application et un mot clef dans le profile spécifié. |
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 demander l'espace de données qu'utilise un profile.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_WINSHELLDATA
- #include "os2.h"
- #include "stdio.h"
-
- void main(void) {
- ULONG ulSiz;
- if (!PrfQueryProfileSize(HINI_USERPROFILE, "MonProg", "MaClef", &ulSiz)) {
- printf("Erreur avec PrfQueryProfileData");
- }
- }
Voir également
Langage de programmation - C pour OS/2 - PrfQueryProfileData
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010