Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Overview►                                            ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINPROGRAMLIST
 
HINI PrfOpenProfile(hab, pszProfileName)
HAB hab;               /* anchor-block handle     */
PSZ pszProfileName;    /* pointer to profile name */
 
The PrfOpenProfile function opens a profile file. If the profile file does
not already exist, this function creates it. This function cannot be used to
open the user-profile or system-profile files.
 
Parameter       Description
────────────────────────────────────────────────────────────────────────────
 
hab             Identifies the anchor block.
 
pszProfileName  Points to the null-terminated string that contains the fully
                qualified filename of the profile file. If no path
                information is included, the default directory for the
                application is used. While not required, it is recommended
                that the extension .ini be used.
 
Return Value
 
The return value is a handle to the profile file if the function is
successful or NULL if an error occurs.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_CALL_NOT_EXECUTED
     PMERR_INVALID_DIRECTORY
 
See Also
 
PrfCloseProfile
 
                                      ♦