The GetConsoleTitle function retrieves the title bar string for the current console window.
DWORD GetConsoleTitle(
| LPTSTR lpConsoleTitle, | // address of buffer for title |
| DWORD nSize | // size of the buffer |
| ); |
Parameters
lpConsoleTitle
Points to a buffer that receives a null-terminated string containing the text that appears in the title bar of the console window.
nSize
Specifies the size, in characters, of the buffer pointed to by the lpConsoleTitle parameter.
Return Values
If the function succeeds, the return value is the length, in characters, of the string copied to the buffer.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
To set the title bar string for a console window, use the SetConsoleTitle function.
Windows NT: This function uses either Unicode characters or 8-bit characters from the console's current codepage. The console's codepage defaults initially to the system's OEM codepage. To change the console's codepage, use the SetConsoleCP or SetConsoleOutputCP functions, or use the chcp or mode con cp select= commands.
See Also