wglDeleteContext

The wglDeleteContext function deletes a specified OpenGL rendering context.

BOOL wglDeleteContext(
  HGLRC  hglrc   // handle to the OpenGL rendering context to delete
);
 

Parameters

hglrc

Handle to an OpenGL rendering context that the function will delete.

Return Values

If the function succeeds, the return value is TRUE.

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

Remarks

It is an error to delete an OpenGL rendering context that is the current context of another thread. However, if a rendering context is the calling thread's current context, the wglDeleteContext function changes the rendering context to being not current before deleting it.

The wglDeleteContext function does not delete the device context associated with the OpenGL rendering context when you call the wglMakeCurrent function. After calling wglDeleteContext, you must call DeleteDC to delete the associated device context.

QuickInfo

  Windows NT: Use version 3.5 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Link with opengl32.lib.

See Also

OpenGL on Windows NT and Windows 95 Overview, WGL Functions, DeleteDC, wglCreateContext, wglGetCurrentContext, wglGetCurrentDC, wglMakeCurrent