3 out of 3 rated this helpful - Rate this topic

GetConsoleCursorInfo function

Applies to: desktop apps only

Retrieves information about the size and visibility of the cursor for the specified console screen buffer.

Syntax

BOOL WINAPI GetConsoleCursorInfo(
  __in   HANDLE hConsoleOutput,
  __out  PCONSOLE_CURSOR_INFO lpConsoleCursorInfo
);

Parameters

hConsoleOutput [in]

A handle to the console screen buffer. The handle must have the GENERIC_READ access right. For more information, see Console Buffer Security and Access Rights.

lpConsoleCursorInfo [out]

A pointer to a CONSOLE_CURSOR_INFO structure that receives information about the console's cursor.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wincon.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Console Functions
Console Screen Buffers
CONSOLE_CURSOR_INFO
SetConsoleCursorInfo

 

 

Send comments about this topic to Microsoft

Build date: 2/3/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Alternative to using unmanaged code API

As an alternative to using this unmanged API in your managed code, consider looking at the System.Windows.Forms.Cursor class. See http://msdn.microsoft.com/en-us/library/system.windows.forms.cursor(VS.71).aspx for more details of this class.

C# syntax
[DllImport("kernel32.dll", SetLastError=true)]
internal static extern bool GetConsoleCursorInfo(IntPtr hConsoleOutput, out CONSOLE_CURSOR_INFO cci);
vb.net syntax
<DllImport("kernel32.dll", SetLastError:=True)> _
Public Shared Function GetConsoleCursorInfo(ByVal hConsoleOutput As IntPtr, <Out> ByRef cci As CONSOLE_CURSOR_INFO) As Boolean End Function