wininet.h header

This header is used by multiple technologies. For more information, see:

wininet.h contains the following programming interfaces:

Functions

 
CommitUrlCacheEntryA

Stores data in the specified file in the Internet cache and associates it with the specified URL. (ANSI)
CommitUrlCacheEntryW

Stores data in the specified file in the Internet cache and associates it with the specified URL. (Unicode)
CreateMD5SSOHash

The CreateMD5SSOHash function (wininet.h) obtains the Microsoft Passport password, creates an MD5 hash using a specific string, and returns the result.
CreateUrlCacheEntryA

Creates a local file name for saving the cache entry based on the specified URL and the file name extension. (ANSI)
CreateUrlCacheEntryW

Creates a local file name for saving the cache entry based on the specified URL and the file name extension. (Unicode)
CreateUrlCacheGroup

Generates cache group identifications.
DeleteUrlCacheEntry

The DeleteUrlCacheEntry function (wininet.h) removes the file associated with the source name from the cache, if the file exists.
DeleteUrlCacheEntryA

Removes the file associated with the source name from the cache, if the file exists. (DeleteUrlCacheEntryA)
DeleteUrlCacheEntryW

The DeleteUrlCacheEntryW (Unicode) function (wininet.h) removes the file associated with the source name from the cache, if the file exists.
DeleteUrlCacheGroup

Releases the specified GROUPID and any associated state in the cache index file.
DetectAutoProxyUrl

The DetectAutoProxyUrl function (wininet.h) attempts to determine the location of a WPAD autoproxy script.
FindCloseUrlCache

Closes the specified cache enumeration handle.
FindFirstUrlCacheEntryA

Begins the enumeration of the Internet cache. (ANSI)
FindFirstUrlCacheEntryExA

Starts a filtered enumeration of the Internet cache. (ANSI)
FindFirstUrlCacheEntryExW

Starts a filtered enumeration of the Internet cache. (Unicode)
FindFirstUrlCacheEntryW

Begins the enumeration of the Internet cache. (Unicode)
FindFirstUrlCacheGroup

Initiates the enumeration of the cache groups in the Internet cache.
FindNextUrlCacheEntryA

Retrieves the next entry in the Internet cache. (ANSI)
FindNextUrlCacheEntryExA

Finds the next cache entry in a cache enumeration started by the FindFirstUrlCacheEntryEx function. (ANSI)
FindNextUrlCacheEntryExW

Finds the next cache entry in a cache enumeration started by the FindFirstUrlCacheEntryEx function. (Unicode)
FindNextUrlCacheEntryW

Retrieves the next entry in the Internet cache. (Unicode)
FindNextUrlCacheGroup

Retrieves the next cache group in a cache group enumeration started by FindFirstUrlCacheGroup.
FtpCommandA

Sends commands directly to an FTP server. (ANSI)
FtpCommandW

Sends commands directly to an FTP server. (Unicode)
FtpCreateDirectoryA

Creates a new directory on the FTP server. (ANSI)
FtpCreateDirectoryW

Creates a new directory on the FTP server. (Unicode)
FtpDeleteFileA

Deletes a file stored on the FTP server. (ANSI)
FtpDeleteFileW

Deletes a file stored on the FTP server. (Unicode)
FtpFindFirstFileA

Searches the specified directory of the given FTP session. File and directory entries are returned to the application in the WIN32_FIND_DATA structure. (ANSI)
FtpFindFirstFileW

Searches the specified directory of the given FTP session. File and directory entries are returned to the application in the WIN32_FIND_DATA structure. (Unicode)
FtpGetCurrentDirectoryA

Retrieves the current directory for the specified FTP session. (ANSI)
FtpGetCurrentDirectoryW

Retrieves the current directory for the specified FTP session. (Unicode)
FtpGetFileA

Retrieves a file from the FTP server and stores it under the specified file name, creating a new local file in the process. (ANSI)
FtpGetFileSize

Retrieves the file size of the requested FTP resource.
FtpGetFileW

Retrieves a file from the FTP server and stores it under the specified file name, creating a new local file in the process. (Unicode)
FtpOpenFileA

Initiates access to a remote file on an FTP server for reading or writing. (ANSI)
FtpOpenFileW

Initiates access to a remote file on an FTP server for reading or writing. (Unicode)
FtpPutFileA

Stores a file on the FTP server. (ANSI)
FtpPutFileW

Stores a file on the FTP server. (Unicode)
FtpRemoveDirectoryA

Removes the specified directory on the FTP server. (ANSI)
FtpRemoveDirectoryW

Removes the specified directory on the FTP server. (Unicode)
FtpRenameFileA

Renames a file stored on the FTP server. (ANSI)
FtpRenameFileW

Renames a file stored on the FTP server. (Unicode)
FtpSetCurrentDirectoryA

Changes to a different working directory on the FTP server. (ANSI)
FtpSetCurrentDirectoryW

Changes to a different working directory on the FTP server. (Unicode)
GetUrlCacheEntryInfoA

Retrieves information about a cache entry. (ANSI)
GetUrlCacheEntryInfoExA

Retrieves information on the cache entry associated with the specified URL, taking into account any redirections that are applied in offline mode by the HttpSendRequest function. (ANSI)
GetUrlCacheEntryInfoExW

Retrieves information on the cache entry associated with the specified URL, taking into account any redirections that are applied in offline mode by the HttpSendRequest function. (Unicode)
GetUrlCacheEntryInfoW

Retrieves information about a cache entry. (Unicode)
GetUrlCacheGroupAttributeA

Retrieves the attribute information of the specified cache group. (ANSI)
GetUrlCacheGroupAttributeW

Retrieves the attribute information of the specified cache group. (Unicode)
GopherCreateLocatorA

Creates a Gopher or Gopher+ locator string from the selector string's component parts. (ANSI)
GopherCreateLocatorW

Creates a Gopher or Gopher+ locator string from the selector string's component parts. (Unicode)
GopherFindFirstFileA

Uses a Gopher locator and search criteria to create a session with the server and locate the requested documents, binary files, index servers, or directory trees. (ANSI)
GopherFindFirstFileW

Uses a Gopher locator and search criteria to create a session with the server and locate the requested documents, binary files, index servers, or directory trees. (Unicode)
GopherGetAttributeA

Retrieves the specific attribute information from the server. (ANSI)
GopherGetAttributeW

Retrieves the specific attribute information from the server. (Unicode)
GopherGetLocatorTypeA

Parses a Gopher locator and determines its attributes. (ANSI)
GopherGetLocatorTypeW

Parses a Gopher locator and determines its attributes. (Unicode)
GopherOpenFileA

Begins reading a Gopher data file from a Gopher server. (ANSI)
GopherOpenFileW

Begins reading a Gopher data file from a Gopher server. (Unicode)
HttpAddRequestHeadersA

Adds one or more HTTP request headers to the HTTP request handle. (HttpAddRequestHeadersA)
HttpAddRequestHeadersW

Adds one or more HTTP request headers to the HTTP request handle. (HttpAddRequestHeadersW)
HttpEndRequestA

Ends an HTTP request that was initiated by HttpSendRequestEx. (ANSI)
HttpEndRequestW

Ends an HTTP request that was initiated by HttpSendRequestEx. (Unicode)
HttpOpenRequestA

Creates an HTTP request handle. (ANSI)
HttpOpenRequestW

Creates an HTTP request handle. (Unicode)
HttpQueryInfoA

Retrieves header information associated with an HTTP request. (ANSI)
HttpQueryInfoW

Retrieves header information associated with an HTTP request. (Unicode)
HttpSendRequestA

Sends the specified request to the HTTP server, allowing callers to send extra data beyond what is normally passed to HttpSendRequestEx. (ANSI)
HttpSendRequestExA

Sends the specified request to the HTTP server. (HttpSendRequestExA)
HttpSendRequestExW

Sends the specified request to the HTTP server. (HttpSendRequestExW)
HttpSendRequestW

Sends the specified request to the HTTP server, allowing callers to send extra data beyond what is normally passed to HttpSendRequestEx. (Unicode)
InternetAttemptConnect

Attempts to make a connection to the Internet.
InternetAutodial

The InternetAutodial function (wininet.h) causes the modem to automatically dial the default Internet connection.
InternetAutodialHangup

The InternetAutodialHangup function (wininet.h) disconnects an automatic dial-up connection.
InternetCanonicalizeUrlA

Canonicalizes a URL, which includes converting unsafe characters and spaces into escape sequences. (ANSI)
InternetCanonicalizeUrlW

Canonicalizes a URL, which includes converting unsafe characters and spaces into escape sequences. (Unicode)
InternetCheckConnectionA

Allows an application to check if a connection to the Internet can be established. (ANSI)
InternetCheckConnectionW

Allows an application to check if a connection to the Internet can be established. (Unicode)
InternetClearAllPerSiteCookieDecisions

Clears all decisions that were made about cookies on a site by site basis.
InternetCloseHandle

Closes a single Internet handle.
InternetCombineUrlA

Combines a base and relative URL into a single URL. The resultant URL is canonicalized (see InternetCanonicalizeUrl). (ANSI)
InternetCombineUrlW

Combines a base and relative URL into a single URL. The resultant URL is canonicalized (see InternetCanonicalizeUrl). (Unicode)
InternetConfirmZoneCrossing

The InternetConfirmZoneCrossing function (wininet.h) checks for changes between secure and nonsecure URLs.
InternetConfirmZoneCrossingA

Checks for changes between secure and nonsecure URLs. Always inform the user when a change occurs in security between two URLs. Typically, an application should allow the user to acknowledge the change through interaction with a dialog box. (InternetConfirmZoneCrossingA)
InternetConfirmZoneCrossingW

The InternetConfirmZoneCrossingW (Unicode) function (wininet.h) checks for changes between secure and nonsecure URLs.
InternetConnectA

Opens an File Transfer Protocol (FTP) or HTTP session for a given site. (ANSI)
InternetConnectW

Opens an File Transfer Protocol (FTP) or HTTP session for a given site. (Unicode)
InternetCrackUrlA

Cracks a URL into its component parts. (ANSI)
InternetCrackUrlW

Cracks a URL into its component parts. (Unicode)
InternetCreateUrlA

Creates a URL from its component parts. (ANSI)
InternetCreateUrlW

Creates a URL from its component parts. (Unicode)
InternetDial

The InternetDial function (wininet.h) initiates a connection to the Internet using a modem.
InternetDialA

The InternetDialA (ANSI) function (wininet.h) initiates a connection to the Internet using a modem.
InternetDialW

The InternetDialW (Unicode) function (wininet.h) initiates a connection to the Internet using a modem.
InternetEnumPerSiteCookieDecisionA

The InternetEnumPerSiteCookieDecisionA (ANSI) function (wininet.h) retrieves the domains and cookie settings of websites with set site-specific cookie regulations.
InternetEnumPerSiteCookieDecisionW

The InternetEnumPerSiteCookieDecisionW (Unicode) function (wininet.h) retrieves the domains and cookie settings of websites with set site-specific cookie regulations.
InternetErrorDlg

Displays a dialog box for the error that is passed to InternetErrorDlg, if an appropriate dialog box exists.
InternetFindNextFileA

Continues a file search started as a result of a previous call to FtpFindFirstFile.Windows XP and Windows Server 2003 R2 and earlier:  Or continues a file search as a result of a previous call to GopherFindFirstFile. (ANSI)
InternetFindNextFileW

Continues a file search started as a result of a previous call to FtpFindFirstFile.Windows XP and Windows Server 2003 R2 and earlier:  Or continues a file search as a result of a previous call to GopherFindFirstFile. (Unicode)
InternetFreeCookies

Frees an array of INTERNET_COOKIE2 structures.
InternetGetConnectedState

The InternetGetConnectedState function (wininet.h) retrieves the connected state of the local system and is not recommended for use.
InternetGetConnectedStateEx

The InternetGetConnectedStateEx function (wininet.h) retrieves the connected state of the specified Internet connection and is not recommended for use.
InternetGetConnectedStateExA

The InternetGetConnectedStateExA (ANSI) function (wininet.h) retrieves the connected state of the specified Internet connection and is not recommended for use.
InternetGetConnectedStateExW

The InternetGetConnectedStateExW (Unicode) function (wininet.h) retrieves the connected state of the specified Internet connection and is not recommended for use.
InternetGetCookieA

Retrieves the cookie for the specified URL. (ANSI)
InternetGetCookieEx2

Retrieves one or more cookies associated with the specified URL.
InternetGetCookieExA

Retrieves data stored in cookies associated with a specified URL. (ANSI)
InternetGetCookieExW

Retrieves data stored in cookies associated with a specified URL. (Unicode)
InternetGetCookieW

Retrieves the cookie for the specified URL. (Unicode)
InternetGetLastResponseInfoA

Retrieves the last error description or server response on the thread calling this function. (ANSI)
InternetGetLastResponseInfoW

Retrieves the last error description or server response on the thread calling this function. (Unicode)
InternetGetPerSiteCookieDecisionA

Retrieves a decision on cookies for a given domain. (ANSI)
InternetGetPerSiteCookieDecisionW

Retrieves a decision on cookies for a given domain. (Unicode)
InternetGoOnline

The InternetGoOnline function (wininet.h) prompts the user for permission to initiate connection to a URL.
InternetGoOnlineA

The InternetGoOnlineA (ANSI) function (wininet.h) prompts the user for permission to initiate connection to a URL.
InternetGoOnlineW

The InternetGoOnlineW (Unicode) function (wininet.h) prompts the user for permission to initiate connection to a URL.
InternetHangUp

The InternetHangUp function (wininet.h) instructs the modem to disconnect from the Internet.
InternetInitializeAutoProxyDll

The InternetInitializeAutoProxyDll function (wininet.h) is one of two WinINet functions named InternetInitializeAutoProxyDll.
InternetLockRequestFile

Places a lock on the file that is being used.
InternetOpenA

Initializes an application's use of the WinINet functions. (ANSI)
InternetOpenUrlA

Opens a resource specified by a complete FTP or HTTP URL. (ANSI)
InternetOpenUrlW

Opens a resource specified by a complete FTP or HTTP URL. (Unicode)
InternetOpenW

Initializes an application's use of the WinINet functions. (Unicode)
InternetQueryDataAvailable

Queries the server to determine the amount of data available.
InternetQueryOptionA

Queries an Internet option on the specified handle. (ANSI)
InternetQueryOptionW

Queries an Internet option on the specified handle. (Unicode)
InternetReadFile

Reads data from a handle opened by the InternetOpenUrl, FtpOpenFile, or HttpOpenRequest function.
InternetReadFileExA

Reads data from a handle opened by the InternetOpenUrl or HttpOpenRequest function. (ANSI)
InternetReadFileExW

Reads data from a handle opened by the InternetOpenUrl or HttpOpenRequest function. (Unicode)
InternetSetCookieA

Creates a cookie associated with the specified URL. (InternetSetCookieA)
InternetSetCookieEx2

Creates a cookie associated with the specified URL. (InternetSetCookieEx2)
InternetSetCookieExA

The InternetSetCookieEx function creates a cookie with a specified name that is associated with a specified URL. This function differs from the InternetSetCookie function by being able to create third-party cookies. (ANSI)
InternetSetCookieExW

The InternetSetCookieEx function creates a cookie with a specified name that is associated with a specified URL. This function differs from the InternetSetCookie function by being able to create third-party cookies. (Unicode)
InternetSetCookieW

Creates a cookie associated with the specified URL. (InternetSetCookieW)
InternetSetDialState

The InternetSetDialState function (wininet.h) is not supported, is obsolete, and should not be used.
InternetSetDialStateA

The InternetSetDialStateA (ANSI) function (wininet.h) is not supported, is obsolete, and should not be used.
InternetSetDialStateW

The InternetSetDialStateW (Unicode) function (wininet.h) is not supported, is obsolete, and should not be used.
InternetSetFilePointer

Sets a file position for InternetReadFile. This is a synchronous call; however, subsequent calls to InternetReadFile might block or return pending if the data is not available from the cache and the server does not support random access.
InternetSetOptionA

Sets an Internet option. (ANSI)
InternetSetOptionExA

Not supported.Implemented only as a stub that calls the InternetSetOption function; InternetSetOptionEx has no functionality of its own. Do not use this function at this time. (ANSI)
InternetSetOptionExW

Not supported.Implemented only as a stub that calls the InternetSetOption function; InternetSetOptionEx has no functionality of its own. Do not use this function at this time. (Unicode)
InternetSetOptionW

Sets an Internet option. (Unicode)
InternetSetPerSiteCookieDecisionA

Sets a decision on cookies for a given domain. (ANSI)
InternetSetPerSiteCookieDecisionW

Sets a decision on cookies for a given domain. (Unicode)
InternetSetStatusCallback

Sets up a callback function that WinINet functions can call as progress is made during an operation.
InternetSetStatusCallbackA

The InternetSetStatusCallbackA (ANSI) function sets up a callback function that WinINet functions can call as progress is made during an operation.
InternetSetStatusCallbackW

The InternetSetStatusCallbackW (Unicode) function sets up a callback function that WinINet functions can call as progress is made during an operation.
InternetTimeFromSystemTime

The InternetTimeFromSystemTime function (wininet.h) formats a date and time according to the HTTP version 1.0 specification.
InternetTimeFromSystemTimeA

Formats a date and time according to the HTTP version 1.0 specification. (InternetTimeFromSystemTimeA)
InternetTimeFromSystemTimeW

The InternetTimeFromSystemTimeW (Unicode) function (wininet.h) formats a date and time according to the HTTP version 1.0 specification.
InternetTimeToSystemTime

The InternetTimeToSystemTime function (wininet.h) converts an HTTP time/date string to a SYSTEMTIME structure.
InternetTimeToSystemTimeA

Converts an HTTP time/date string to a SYSTEMTIME structure. (InternetTimeToSystemTimeA)
InternetTimeToSystemTimeW

The InternetTimeToSystemTimeW (Unicode) function (wininet.h) converts an HTTP time/date string to a SYSTEMTIME structure.
InternetUnlockRequestFile

Unlocks a file that was locked using InternetLockRequestFile.
InternetWriteFile

Writes data to an open Internet file.
PrivacyGetZonePreferenceW

The PrivacyGetZonePreferenceW (Unicode) function (wininet.h) retrieves the privacy settings for a given URLZONE and PrivacyType.
PrivacySetZonePreferenceW

The PrivacySetZonePreferenceW (Unicode) function (wininet.h) sets the privacy settings for a given URLZONE and PrivacyType.
ReadUrlCacheEntryStream

Reads the cached data from a stream that has been opened using the RetrieveUrlCacheEntryStream function.
ResumeSuspendedDownload

The ResumeSuspendedDownload function resumes a request that is suspended by a user interface dialog box.
RetrieveUrlCacheEntryFileA

Locks the cache entry file associated with the specified URL. (ANSI)
RetrieveUrlCacheEntryFileW

Locks the cache entry file associated with the specified URL. (Unicode)
RetrieveUrlCacheEntryStreamA

Provides the most efficient and implementation-independent way to access the cache data. (ANSI)
RetrieveUrlCacheEntryStreamW

Provides the most efficient and implementation-independent way to access the cache data. (Unicode)
SetUrlCacheEntryGroup

The SetUrlCacheEntryGroup function (wininet.h) adds entries to or removes entries from a cache group.
SetUrlCacheEntryGroupA

Adds entries to or removes entries from a cache group. (SetUrlCacheEntryGroupA)
SetUrlCacheEntryGroupW

The SetUrlCacheEntryGroupW (Unicode) function (wininet.h) adds entries to or removes entries from a cache group.
SetUrlCacheEntryInfoA

Sets the specified members of the INTERNET_CACHE_ENTRY_INFO structure. (ANSI)
SetUrlCacheEntryInfoW

Sets the specified members of the INTERNET_CACHE_ENTRY_INFO structure. (Unicode)
SetUrlCacheGroupAttributeA

Sets the attribute information of the specified cache group. (ANSI)
SetUrlCacheGroupAttributeW

Sets the attribute information of the specified cache group. (Unicode)
UnlockUrlCacheEntryFile

The UnlockUrlCacheEntryFile function (wininet.h) unlocks the cache entry that was locked while the file was retrieved for use from the cache.
UnlockUrlCacheEntryFileA

Unlocks the cache entry that was locked while the file was retrieved for use from the cache. (UnlockUrlCacheEntryFileA)
UnlockUrlCacheEntryFileW

The UnlockUrlCacheEntryFileW (Unicode) function (wininet.h) unlocks the cache entry that was locked while the file was retrieved for use from the cache.
UnlockUrlCacheEntryStream

Closes the stream that has been retrieved using the RetrieveUrlCacheEntryStream function.

Callback functions

 
GOPHER_ATTRIBUTE_ENUMERATOR

Prototype for a callback function that processes attribute information from a Gopher server.
INTERNET_STATUS_CALLBACK

Defines a pointer to this callback function.

Structures

 
AUTO_PROXY_SCRIPT_BUFFER

The AUTO_PROXY_SCRIPT_BUFFER structure is used to pass an autoproxy script in a buffer to InternetInitializeAutoProxyDll , instead of identifying a file that InternetInitializeAutoProxyDll opens.
AutoProxyHelperFunctions

The AutoProxyHelperFunctions structure is used create a v-table of Proxy Auto-Config functions that can be passed to InternetInitializeAutoProxyDll.
AutoProxyHelperVtbl

The AutoProxyHelperVtbl structure creates a v-table of pointers to Proxy AutoConfig (PAC) helper functions.See the Navigator Proxy Auto-Config (PAC) File Format documentation for a specification of the form and use of Proxy Auto-Config helper functions.
GOPHER_ATTRIBUTE_TYPE

Contains the relevant information of a single Gopher attribute for an object.
GOPHER_FIND_DATAA

Contains information retrieved by the GopherFindFirstFile and InternetFindNextFile functions. (ANSI)
GOPHER_FIND_DATAW

Contains information retrieved by the GopherFindFirstFile and InternetFindNextFile functions. (Unicode)
HTTP_VERSION_INFO

Contains the global HTTP version.
INTERNET_ASYNC_RESULT

Contains the result of a call to an asynchronous function. This structure is used with InternetStatusCallback.
INTERNET_AUTH_NOTIFY_DATA

Contains the notification data for an authentication request.
INTERNET_BUFFERSA

Contains both the data and header information. (ANSI)
INTERNET_BUFFERSW

Contains both the data and header information. (Unicode)
INTERNET_CACHE_ENTRY_INFOA

Contains information about an entry in the Internet cache. (ANSI)
INTERNET_CACHE_ENTRY_INFOW

Contains information about an entry in the Internet cache. (Unicode)
INTERNET_CACHE_GROUP_INFOA

Contains the information for a particular cache group. (ANSI)
INTERNET_CACHE_GROUP_INFOW

Contains the information for a particular cache group. (Unicode)
INTERNET_CACHE_TIMESTAMPS

Contains the LastModified and Expire times for a resource stored in the Internet cache.
INTERNET_CERTIFICATE_INFO

Contains certificate information returned from the server. This structure is used by the InternetQueryOption function.
INTERNET_CONNECTED_INFO

Contains the information to set the global online/offline state.
INTERNET_COOKIE2

The INTERNET_COOKIE2 structure contains the constituent parts of a cookie. This structure is used with the InternetGetCookieEx2 and InternetSetCookieEx2 functions.
INTERNET_DIAGNOSTIC_SOCKET_INFO

The INTERNET_DIAGNOSTIC_SOCKET_INFO structure is returned by the InternetQueryOption function when the INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO flag is passed to it together with a handle to an HTTP Request.
INTERNET_PER_CONN_OPTION_LISTA

Contains the list of options for a particular Internet connection. (ANSI)
INTERNET_PER_CONN_OPTION_LISTW

Contains the list of options for a particular Internet connection. (Unicode)
INTERNET_PER_CONN_OPTIONA

Contains the value of an option. (ANSI)
INTERNET_PER_CONN_OPTIONW

Contains the value of an option. (Unicode)
INTERNET_PROXY_INFO

Contains information that is supplied with the INTERNET_OPTION_PROXY value to get or set proxy information on a handle obtained from a call to the InternetOpen function.
INTERNET_VERSION_INFO

Contains the HTTP version number of the server. This structure is used when passing the INTERNET_OPTION_VERSION flag to the InternetQueryOption function.
InternetCookieHistory

The InternetCookieHistory structure contains the cookie history.
URL_COMPONENTSA

Contains the constituent parts of a URL. This structure is used with the InternetCrackUrl and InternetCreateUrl functions. (ANSI)
URL_COMPONENTSW

Contains the constituent parts of a URL. This structure is used with the InternetCrackUrl and InternetCreateUrl functions. (Unicode)

Enumerations

 
INTERNET_SCHEME

Defines the flags used with the nScheme member of the URL_COMPONENTS structure.
InternetCookieState

The InternetCookieState enumeration defines the state of the cookie.