wpQueryFilename

This method is specific to version 3, or higher, of the OS/2 operating system.

This instance method copies the fully-qualified or unqualified file name to a buffer.

Syntax

_wpQueryFilename(somSelf, pszFilename, fQualified)

Parameters

somSelf (WPFileSystem *) - input

Pointer to the object on which the method is being invoked.

Points to an object of class WPFileSystem.

pszFilename (PSZ) - output

Pointer to the buffer containing the output file name.

This buffer must be at least **CCHMAXPATH** characters in length.

fQualified (BOOL) - input

Qualification requested flag.

Possible values are as follows:

• TRUE Output file name is fully qualified.
• FALSE Output file name is unqualified.

Returns

pszBuf (PSZ) - returns

Pointer to the buffer containing the output filename.

If the file exists, **pszFilename** is returned. If the file does not exist, **NULL** is returned.

Example Code

#define INCL_WINWORKPLACE
#include <os2.h>

WPFileSystem *somSelf; /* Pointer to the object on which the method is being invoked. */
PSZ pszFilename; /* Pointer to the buffer containing the output file name. */
BOOL fQualified; /* Qualification requested flag. */
PSZ pszBuf; /* Pointer to the buffer containing the output filename. */

pszBuf = _wpQueryFilename(somSelf, pszFilename,
          fQualified);