Windows System Programming Third Edition

EXAMPLE: PRINTING THE CURRENT DIRECTORY

51

is the character (not byte) length of the buffer for the directory name.

The length must allow for the terminating null character.

points to the

buffer to receive the pathname string.

Notice that if the buffer is too small for the pathname, the return value tells

how large the buffer should be. Therefore, the test for function failure should test

both for zero and for the result being larger than the

argument.

This method of returning strings and their lengths is common in Windows and

must be handled carefully. Program 2–6 illustrates a typical code fragment that

performs the logic. Similar logic occurs