Section courante

A propos

Section administrative du site

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 :

  1. #define INCL_WINSHELLDATA
  2. #include "os2.h"
  3. #include "stdio.h"
  4.  
  5. void main(void) {
  6.     ULONG ulSiz;
  7.     if (!PrfQueryProfileSize(HINI_USERPROFILE, "MonProg", "MaClef", &ulSiz)) {
  8.         printf("Erreur avec PrfQueryProfileData");
  9.     }
  10. }

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