GWin32InputStream: GIO Reference Manual

## GWin32InputStream GWin32InputStream — Streaming input operations for Windows file handles |

## Functions

GInputStream * | g_win32_input_stream_new ()
void | g_win32_input_stream_set_close_handle ()
gboolean | g_win32_input_stream_get_close_handle ()
void * | g_win32_input_stream_get_handle ()

## Types and Values

struct | GWin32InputStream

## Includes

    #include <gio/gwin32inputstream.h>

## Description

GWin32InputStream implements GInputStream for reading from a Windows file handle.

Note that `<gio/gwin32inputstream.h>` belongs to the Windows-specific GIO interfaces, thus you have to use the `gio-windows-2.0.pc` pkg-config file when using it.

## Functions

### g_win32_input_stream_new ()

    GInputStream *
    g_win32_input_stream_new (void *handle,
                              gboolean close_handle);

Creates a new GWin32InputStream for the given `handle` .

If `close_handle` is `TRUE`, the handle will be closed when the stream is closed.

Note that "handle" here means a Win32 HANDLE, not a "file descriptor" as used in the Windows C libraries.

#### Parameters

handle | a Win32 file handle |
close_handle | `TRUE` to close the handle when done |

#### Returns

a new GWin32InputStream

### g_win32_input_stream_set_close_handle ()

    void
    g_win32_input_stream_set_close_handle (GWin32InputStream *stream,
                                           gboolean close_handle);

Sets whether the handle of `stream` shall be closed when the stream is closed.

#### Parameters

stream | a GWin32InputStream |
close_handle | `TRUE` to close the handle when done |

Since 2.26

### g_win32_input_stream_get_close_handle ()

    gboolean
    g_win32_input_stream_get_close_handle (GWin32InputStream *stream);

Returns whether the handle of `stream` will be closed when the stream is closed.

#### Parameters

stream | a GWin32InputStream |

#### Returns

`TRUE` if the handle is closed when done

Since 2.26

### g_win32_input_stream_get_handle ()

    void *
    g_win32_input_stream_get_handle (GWin32InputStream *stream);

Return the Windows file handle that the stream reads from.

#### Parameters

stream | a GWin32InputStream |

#### Returns

The file handle of `stream`

Since 2.26

## Types and Values

### struct GWin32InputStream

    struct GWin32InputStream {
      GInputStream parent_instance;
    };

Implements GInputStream for reading from selectable Windows file handles

## See Also

GInputStream