.\" -*- nroff -*- .\" Generated file - DO NOT EDIT! .TH InternetGetConnectedStateExW 3w "Oct 2012" "Wine API" "Wine API" .SH NAME \fBInternetGetConnectedStateExW\fR (WININET.@) .SH SYNOPSIS BOOL InternetGetConnectedStateExW ( LPDWORD \fIlpdwStatus\fR, LPWSTR \fIlpszConnectionName\fR, DWORD \fIdwNameLen\fR, DWORD \fIdwReserved\fR ) .SH DESCRIPTION .PP Return connected state. .SH PARAMS \fIlpdwStatus\fR \fB[Out]\fR Flags specifying the status of the internet connection. .PP \fIlpszConnectionName\fR \fB[Out]\fR Pointer to buffer to receive the friendly name of the internet connection. .PP \fIdwNameLen\fR \fB[In]\fR Size of the buffer, in characters. .PP \fIdwReserved\fR \fB[In]\fR Reserved. Must be set to \fB0.\fR .PP .SH RETURNS .PP \fBTRUE\fR if connected if \fIlpdwStatus\fR is not \fBNULL\fR, return the status (off line, modem, lan.\fB..\fR) in it. \fBFALSE\fR if not connected. .SH NOTES .PP If the system has no available network connections, an empty string is stored in \fIlpszConnectionName\fR. If there is a \fBLAN\fR connection, a localized \fB"LAN Connection"\fR string is stored. Presumably, if only a dial-up connection is available then the name of the dial-up connection is returned. Why any application, other than the \fB"Internet Settings"\fR \fBCPL\fR, would want to use this function instead of the simpler InternetGetConnectedStateW function is beyond me. .SH IMPLEMENTATION .PP Declared in \fB"wininet.h"\fR. .PP Implemented in \fB"dlls/wininet/internet.c"\fR. .PP Debug channel \fB"wininet"\fR.