InternetCheckConnectionInternetCheckConnection*
*Contents  *Index  *Topic Contents
*Previous Topic: InternetAttemptConnect
*Next Topic: InternetCloseHandle

InternetCheckConnection

BOOL InternetCheckConnection(
    IN LPCSTR lpszUrl,
    IN DWORD dwFlags,
    IN DWORD dwReserved
);

Allows an application to check if a connection to the Internet can be established.

lpszUrl
Address of a string containing the Uniform Resource Locator (URL) to use to check the connection. This value can be set to NULL.
dwFlags
Unsigned long integer value containing the flag values. FLAG_ICC_FORCE_CONNECTION is the only flag that is currently available. If this flag is set, it forces a connection. A sockets connection is attempted in the following order:
  • If lpszUrl is non-NULL, the host value is extracted from it and used to ping that specific host.
  • If lpszUrl is NULL and there is an entry in WinInet's internal server database for the nearest sever, the host value is extracted from the entry and used to ping that server.
dwReserved
Reserved, must be zero.

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.