mirror of https://github.com/tongzx/nt5src
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3061 lines
94 KiB
3061 lines
94 KiB
/*++
|
|
|
|
Copyright (c) 1995-1997 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
wininet.h
|
|
|
|
Abstract:
|
|
|
|
Contains manifests, macros, types and prototypes for Microsoft Windows
|
|
Internet Extensions
|
|
|
|
--*/
|
|
|
|
#if !defined(_WININET_)
|
|
#define _WININET_
|
|
|
|
|
|
/*
|
|
* Set up Structure Packing to be 4 bytes
|
|
* for all wininet structures
|
|
*/
|
|
|
|
#pragma pack(push, wininet, 4)
|
|
|
|
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
#if !defined(_WINX32_)
|
|
#define INTERNETAPI DECLSPEC_IMPORT
|
|
#define URLCACHEAPI DECLSPEC_IMPORT
|
|
#else
|
|
#define INTERNETAPI
|
|
#define URLCACHEAPI
|
|
#endif
|
|
|
|
#define BOOLAPI INTERNETAPI BOOL WINAPI
|
|
|
|
//
|
|
// internet types
|
|
//
|
|
|
|
typedef LPVOID HINTERNET;
|
|
typedef HINTERNET * LPHINTERNET;
|
|
|
|
typedef WORD INTERNET_PORT;
|
|
typedef INTERNET_PORT * LPINTERNET_PORT;
|
|
|
|
//
|
|
// Internet APIs
|
|
//
|
|
|
|
//
|
|
// manifests
|
|
//
|
|
|
|
#define INTERNET_INVALID_PORT_NUMBER 0 // use the protocol-specific default
|
|
|
|
#define INTERNET_DEFAULT_FTP_PORT 21 // default for FTP servers
|
|
#define INTERNET_DEFAULT_GOPHER_PORT 70 // " " gopher "
|
|
#define INTERNET_DEFAULT_HTTP_PORT 80 // " " HTTP "
|
|
#define INTERNET_DEFAULT_HTTPS_PORT 443 // " " HTTPS "
|
|
#define INTERNET_DEFAULT_SOCKS_PORT 1080 // default for SOCKS firewall servers.
|
|
|
|
|
|
//
|
|
// maximum field lengths (arbitrary)
|
|
//
|
|
|
|
#define INTERNET_MAX_HOST_NAME_LENGTH 256
|
|
#define INTERNET_MAX_USER_NAME_LENGTH 128
|
|
#define INTERNET_MAX_PASSWORD_LENGTH 128
|
|
#define INTERNET_MAX_PORT_NUMBER_LENGTH 5 // INTERNET_PORT is unsigned short
|
|
#define INTERNET_MAX_PORT_NUMBER_VALUE 65535 // maximum unsigned short value
|
|
#define INTERNET_MAX_PATH_LENGTH 2048
|
|
#define INTERNET_MAX_SCHEME_LENGTH 32 // longest protocol name length
|
|
#define INTERNET_MAX_URL_LENGTH (INTERNET_MAX_SCHEME_LENGTH \
|
|
+ sizeof("://") \
|
|
+ INTERNET_MAX_PATH_LENGTH)
|
|
|
|
//
|
|
// values returned by InternetQueryOption() with INTERNET_OPTION_KEEP_CONNECTION:
|
|
//
|
|
|
|
#define INTERNET_KEEP_ALIVE_UNKNOWN ((DWORD)-1)
|
|
#define INTERNET_KEEP_ALIVE_ENABLED 1
|
|
#define INTERNET_KEEP_ALIVE_DISABLED 0
|
|
|
|
//
|
|
// flags returned by InternetQueryOption() with INTERNET_OPTION_REQUEST_FLAGS
|
|
//
|
|
|
|
#define INTERNET_REQFLAG_FROM_CACHE 0x00000001 // response came from cache
|
|
#define INTERNET_REQFLAG_ASYNC 0x00000002 // request was made asynchronously
|
|
#define INTERNET_REQFLAG_VIA_PROXY 0x00000004 // request was made via a proxy
|
|
#define INTERNET_REQFLAG_NO_HEADERS 0x00000008 // orginal response contained no headers
|
|
#define INTERNET_REQFLAG_PASSIVE 0x00000010 // FTP: passive-mode connection
|
|
#define INTERNET_REQFLAG_CACHE_WRITE_DISABLED 0x00000040 // HTTPS: this request not cacheable
|
|
|
|
//
|
|
// flags common to open functions (not InternetOpen()):
|
|
//
|
|
|
|
#define INTERNET_FLAG_RELOAD 0x80000000 // retrieve the original item
|
|
|
|
//
|
|
// flags for InternetOpenUrl():
|
|
//
|
|
|
|
#define INTERNET_FLAG_RAW_DATA 0x40000000 // FTP/gopher find: receive the item as raw (structured) data
|
|
#define INTERNET_FLAG_EXISTING_CONNECT 0x20000000 // FTP: use existing InternetConnect handle for server if possible
|
|
|
|
//
|
|
// flags for InternetOpen():
|
|
//
|
|
|
|
#define INTERNET_FLAG_ASYNC 0x10000000 // this request is asynchronous (where supported)
|
|
|
|
//
|
|
// protocol-specific flags:
|
|
//
|
|
|
|
#define INTERNET_FLAG_PASSIVE 0x08000000 // used for FTP connections
|
|
|
|
//
|
|
// additional cache flags
|
|
//
|
|
|
|
#define INTERNET_FLAG_NO_CACHE_WRITE 0x04000000 // don't write this item to the cache
|
|
#define INTERNET_FLAG_DONT_CACHE INTERNET_FLAG_NO_CACHE_WRITE
|
|
#define INTERNET_FLAG_MAKE_PERSISTENT 0x02000000 // make this item persistent in cache
|
|
#define INTERNET_FLAG_FROM_CACHE 0x01000000 // use offline semantics
|
|
#define INTERNET_FLAG_OFFLINE INTERNET_FLAG_FROM_CACHE
|
|
|
|
//
|
|
// additional flags
|
|
//
|
|
|
|
#define INTERNET_FLAG_SECURE 0x00800000 // use PCT/SSL if applicable (HTTP)
|
|
#define INTERNET_FLAG_KEEP_CONNECTION 0x00400000 // use keep-alive semantics
|
|
#define INTERNET_FLAG_NO_AUTO_REDIRECT 0x00200000 // don't handle redirections automatically
|
|
#define INTERNET_FLAG_READ_PREFETCH 0x00100000 // do background read prefetch
|
|
#define INTERNET_FLAG_NO_COOKIES 0x00080000 // no automatic cookie handling
|
|
#define INTERNET_FLAG_NO_AUTH 0x00040000 // no automatic authentication handling
|
|
#define INTERNET_FLAG_CACHE_IF_NET_FAIL 0x00010000 // return cache file if net request fails
|
|
|
|
//
|
|
// Security Ignore Flags, Allow HttpOpenRequest to overide
|
|
// Secure Channel (SSL/PCT) failures of the following types.
|
|
//
|
|
|
|
#define INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP 0x00008000 // ex: https:// to http://
|
|
#define INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS 0x00004000 // ex: http:// to https://
|
|
#define INTERNET_FLAG_IGNORE_CERT_DATE_INVALID 0x00002000 // expired X509 Cert.
|
|
#define INTERNET_FLAG_IGNORE_CERT_CN_INVALID 0x00001000 // bad common name in X509 Cert.
|
|
|
|
//
|
|
// more caching flags
|
|
//
|
|
|
|
#define INTERNET_FLAG_RESYNCHRONIZE 0x00000800 // asking wininet to update an item if it is newer
|
|
#define INTERNET_FLAG_HYPERLINK 0x00000400 // asking wininet to do hyperlinking semantic which works right for scripts
|
|
#define INTERNET_FLAG_NO_UI 0x00000200 // no cookie popup
|
|
#define INTERNET_FLAG_PRAGMA_NOCACHE 0x00000100 // asking wininet to add "pragma: no-cache"
|
|
#define INTERNET_FLAG_CACHE_ASYNC 0x00000080 // ok to perform lazy cache-write
|
|
#define INTERNET_FLAG_FORMS_SUBMIT 0x00000040 // this is a forms submit
|
|
#define INTERNET_FLAG_NEED_FILE 0x00000010 // need a file for this request
|
|
#define INTERNET_FLAG_MUST_CACHE_REQUEST INTERNET_FLAG_NEED_FILE
|
|
|
|
//
|
|
// flags for FTP
|
|
//
|
|
|
|
#define INTERNET_FLAG_TRANSFER_ASCII FTP_TRANSFER_TYPE_ASCII // 0x00000001
|
|
#define INTERNET_FLAG_TRANSFER_BINARY FTP_TRANSFER_TYPE_BINARY // 0x00000002
|
|
|
|
//
|
|
// flags field masks
|
|
//
|
|
|
|
#define SECURITY_INTERNET_MASK (INTERNET_FLAG_IGNORE_CERT_CN_INVALID | \
|
|
INTERNET_FLAG_IGNORE_CERT_DATE_INVALID | \
|
|
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS | \
|
|
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP )
|
|
|
|
#define INTERNET_FLAGS_MASK (INTERNET_FLAG_RELOAD \
|
|
| INTERNET_FLAG_RAW_DATA \
|
|
| INTERNET_FLAG_EXISTING_CONNECT \
|
|
| INTERNET_FLAG_ASYNC \
|
|
| INTERNET_FLAG_PASSIVE \
|
|
| INTERNET_FLAG_NO_CACHE_WRITE \
|
|
| INTERNET_FLAG_MAKE_PERSISTENT \
|
|
| INTERNET_FLAG_FROM_CACHE \
|
|
| INTERNET_FLAG_SECURE \
|
|
| INTERNET_FLAG_KEEP_CONNECTION \
|
|
| INTERNET_FLAG_NO_AUTO_REDIRECT \
|
|
| INTERNET_FLAG_READ_PREFETCH \
|
|
| INTERNET_FLAG_NO_COOKIES \
|
|
| INTERNET_FLAG_NO_AUTH \
|
|
| INTERNET_FLAG_CACHE_IF_NET_FAIL \
|
|
| SECURITY_INTERNET_MASK \
|
|
| INTERNET_FLAG_RESYNCHRONIZE \
|
|
| INTERNET_FLAG_HYPERLINK \
|
|
| INTERNET_FLAG_NO_UI \
|
|
| INTERNET_FLAG_PRAGMA_NOCACHE \
|
|
| INTERNET_FLAG_CACHE_ASYNC \
|
|
| INTERNET_FLAG_FORMS_SUBMIT \
|
|
| INTERNET_FLAG_NEED_FILE \
|
|
| INTERNET_FLAG_TRANSFER_BINARY \
|
|
| INTERNET_FLAG_TRANSFER_ASCII \
|
|
)
|
|
|
|
#define INTERNET_ERROR_MASK_INSERT_CDROM 0x1
|
|
|
|
#define INTERNET_OPTIONS_MASK (~INTERNET_FLAGS_MASK)
|
|
|
|
//
|
|
// common per-API flags (new APIs)
|
|
//
|
|
|
|
#define WININET_API_FLAG_ASYNC 0x00000001 // force async operation
|
|
#define WININET_API_FLAG_SYNC 0x00000004 // force sync operation
|
|
#define WININET_API_FLAG_USE_CONTEXT 0x00000008 // use value supplied in dwContext (even if 0)
|
|
|
|
//
|
|
// INTERNET_NO_CALLBACK - if this value is presented as the dwContext parameter
|
|
// then no call-backs will be made for that API
|
|
//
|
|
|
|
#define INTERNET_NO_CALLBACK 0
|
|
|
|
//
|
|
// structures/types
|
|
//
|
|
|
|
//
|
|
// INTERNET_SCHEME - enumerated URL scheme type
|
|
//
|
|
|
|
typedef enum {
|
|
INTERNET_SCHEME_PARTIAL = -2,
|
|
INTERNET_SCHEME_UNKNOWN = -1,
|
|
INTERNET_SCHEME_DEFAULT = 0,
|
|
INTERNET_SCHEME_FTP,
|
|
INTERNET_SCHEME_GOPHER,
|
|
INTERNET_SCHEME_HTTP,
|
|
INTERNET_SCHEME_HTTPS,
|
|
INTERNET_SCHEME_FILE,
|
|
INTERNET_SCHEME_NEWS,
|
|
INTERNET_SCHEME_MAILTO,
|
|
INTERNET_SCHEME_SOCKS,
|
|
INTERNET_SCHEME_FIRST = INTERNET_SCHEME_FTP,
|
|
INTERNET_SCHEME_LAST = INTERNET_SCHEME_SOCKS
|
|
} INTERNET_SCHEME, * LPINTERNET_SCHEME;
|
|
|
|
//
|
|
// INTERNET_ASYNC_RESULT - this structure is returned to the application via
|
|
// the callback with INTERNET_STATUS_REQUEST_COMPLETE. It is not sufficient to
|
|
// just return the result of the async operation. If the API failed then the
|
|
// app cannot call GetLastError() because the thread context will be incorrect.
|
|
// Both the value returned by the async API and any resultant error code are
|
|
// made available. The app need not check dwError if dwResult indicates that
|
|
// the API succeeded (in this case dwError will be ERROR_SUCCESS)
|
|
//
|
|
|
|
typedef struct {
|
|
|
|
//
|
|
// dwResult - the HINTERNET, DWORD or BOOL return code from an async API
|
|
//
|
|
|
|
DWORD dwResult;
|
|
|
|
//
|
|
// dwError - the error code if the API failed
|
|
//
|
|
|
|
DWORD dwError;
|
|
} INTERNET_ASYNC_RESULT, * LPINTERNET_ASYNC_RESULT;
|
|
|
|
|
|
//
|
|
// INTERNET_PROXY_INFO - structure supplied with INTERNET_OPTION_PROXY to get/
|
|
// set proxy information on a InternetOpen() handle
|
|
//
|
|
|
|
typedef struct {
|
|
|
|
//
|
|
// dwAccessType - INTERNET_OPEN_TYPE_DIRECT, INTERNET_OPEN_TYPE_PROXY, or
|
|
// INTERNET_OPEN_TYPE_PRECONFIG (set only)
|
|
//
|
|
|
|
DWORD dwAccessType;
|
|
|
|
//
|
|
// lpszProxy - proxy server list
|
|
//
|
|
|
|
LPCTSTR lpszProxy;
|
|
|
|
//
|
|
// lpszProxyBypass - proxy bypass list
|
|
//
|
|
|
|
LPCTSTR lpszProxyBypass;
|
|
} INTERNET_PROXY_INFO, * LPINTERNET_PROXY_INFO;
|
|
|
|
//
|
|
// INTERNET_VERSION_INFO - version information returned via
|
|
// InternetQueryOption(..., INTERNET_OPTION_VERSION, ...)
|
|
//
|
|
|
|
typedef struct {
|
|
DWORD dwMajorVersion;
|
|
DWORD dwMinorVersion;
|
|
} INTERNET_VERSION_INFO, * LPINTERNET_VERSION_INFO;
|
|
|
|
//
|
|
// HTTP_VERSION_INFO - query or set global HTTP version (1.0 or 1.1)
|
|
//
|
|
|
|
typedef struct {
|
|
DWORD dwMajorVersion;
|
|
DWORD dwMinorVersion;
|
|
} HTTP_VERSION_INFO, * LPHTTP_VERSION_INFO;
|
|
|
|
//
|
|
// INTERNET_CONNECTED_INFO - information used to set the global connected state
|
|
//
|
|
|
|
typedef struct {
|
|
|
|
//
|
|
// dwConnectedState - new connected/disconnected state.
|
|
// See INTERNET_STATE_CONNECTED, etc.
|
|
//
|
|
|
|
DWORD dwConnectedState;
|
|
|
|
//
|
|
// dwFlags - flags controlling connected->disconnected (or disconnected->
|
|
// connected) transition. See below
|
|
//
|
|
|
|
DWORD dwFlags;
|
|
} INTERNET_CONNECTED_INFO, * LPINTERNET_CONNECTED_INFO;
|
|
|
|
|
|
//
|
|
// flags for INTERNET_CONNECTED_INFO dwFlags
|
|
//
|
|
|
|
//
|
|
// ISO_FORCE_DISCONNECTED - if set when putting Wininet into disconnected mode,
|
|
// all outstanding requests will be aborted with a cancelled error
|
|
//
|
|
|
|
#define ISO_FORCE_DISCONNECTED 0x00000001
|
|
|
|
|
|
//
|
|
// URL_COMPONENTS - the constituent parts of an URL. Used in InternetCrackUrl()
|
|
// and InternetCreateUrl()
|
|
//
|
|
// For InternetCrackUrl(), if a pointer field and its corresponding length field
|
|
// are both 0 then that component is not returned. If the pointer field is NULL
|
|
// but the length field is not zero, then both the pointer and length fields are
|
|
// returned if both pointer and corresponding length fields are non-zero then
|
|
// the pointer field points to a buffer where the component is copied. The
|
|
// component may be un-escaped, depending on dwFlags
|
|
//
|
|
// For InternetCreateUrl(), the pointer fields should be NULL if the component
|
|
// is not required. If the corresponding length field is zero then the pointer
|
|
// field is the address of a zero-terminated string. If the length field is not
|
|
// zero then it is the string length of the corresponding pointer field
|
|
//
|
|
|
|
typedef struct {
|
|
DWORD dwStructSize; // size of this structure. Used in version check
|
|
LPSTR lpszScheme; // pointer to scheme name
|
|
DWORD dwSchemeLength; // length of scheme name
|
|
INTERNET_SCHEME nScheme; // enumerated scheme type (if known)
|
|
LPSTR lpszHostName; // pointer to host name
|
|
DWORD dwHostNameLength; // length of host name
|
|
INTERNET_PORT nPort; // converted port number
|
|
LPSTR lpszUserName; // pointer to user name
|
|
DWORD dwUserNameLength; // length of user name
|
|
LPSTR lpszPassword; // pointer to password
|
|
DWORD dwPasswordLength; // length of password
|
|
LPSTR lpszUrlPath; // pointer to URL-path
|
|
DWORD dwUrlPathLength; // length of URL-path
|
|
LPSTR lpszExtraInfo; // pointer to extra information (e.g. ?foo or #foo)
|
|
DWORD dwExtraInfoLength; // length of extra information
|
|
} URL_COMPONENTSA, * LPURL_COMPONENTSA;
|
|
typedef struct {
|
|
DWORD dwStructSize; // size of this structure. Used in version check
|
|
LPWSTR lpszScheme; // pointer to scheme name
|
|
DWORD dwSchemeLength; // length of scheme name
|
|
INTERNET_SCHEME nScheme; // enumerated scheme type (if known)
|
|
LPWSTR lpszHostName; // pointer to host name
|
|
DWORD dwHostNameLength; // length of host name
|
|
INTERNET_PORT nPort; // converted port number
|
|
LPWSTR lpszUserName; // pointer to user name
|
|
DWORD dwUserNameLength; // length of user name
|
|
LPWSTR lpszPassword; // pointer to password
|
|
DWORD dwPasswordLength; // length of password
|
|
LPWSTR lpszUrlPath; // pointer to URL-path
|
|
DWORD dwUrlPathLength; // length of URL-path
|
|
LPWSTR lpszExtraInfo; // pointer to extra information (e.g. ?foo or #foo)
|
|
DWORD dwExtraInfoLength; // length of extra information
|
|
} URL_COMPONENTSW, * LPURL_COMPONENTSW;
|
|
#ifdef UNICODE
|
|
typedef URL_COMPONENTSW URL_COMPONENTS;
|
|
typedef LPURL_COMPONENTSW LPURL_COMPONENTS;
|
|
#else
|
|
typedef URL_COMPONENTSA URL_COMPONENTS;
|
|
typedef LPURL_COMPONENTSA LPURL_COMPONENTS;
|
|
#endif // UNICODE
|
|
|
|
|
|
//
|
|
// INTERNET_CERTIFICATE_INFO lpBuffer - contains the certificate returned from
|
|
// the server
|
|
//
|
|
|
|
typedef struct {
|
|
|
|
//
|
|
// ftExpiry - date the certificate expires.
|
|
//
|
|
|
|
FILETIME ftExpiry;
|
|
|
|
//
|
|
// ftStart - date the certificate becomes valid.
|
|
//
|
|
|
|
FILETIME ftStart;
|
|
|
|
//
|
|
// lpszSubjectInfo - the name of organization, site, and server
|
|
// the cert. was issued for.
|
|
//
|
|
|
|
LPTSTR lpszSubjectInfo;
|
|
|
|
//
|
|
// lpszIssuerInfo - the name of orgainzation, site, and server
|
|
// the cert was issues by.
|
|
//
|
|
|
|
LPTSTR lpszIssuerInfo;
|
|
|
|
//
|
|
// lpszProtocolName - the name of the protocol used to provide the secure
|
|
// connection.
|
|
//
|
|
|
|
LPTSTR lpszProtocolName;
|
|
|
|
//
|
|
// lpszSignatureAlgName - the name of the algorithm used for signing
|
|
// the certificate.
|
|
//
|
|
|
|
LPTSTR lpszSignatureAlgName;
|
|
|
|
//
|
|
// lpszEncryptionAlgName - the name of the algorithm used for
|
|
// doing encryption over the secure channel (SSL/PCT) connection.
|
|
//
|
|
|
|
LPTSTR lpszEncryptionAlgName;
|
|
|
|
//
|
|
// dwKeySize - size of the key.
|
|
//
|
|
|
|
DWORD dwKeySize;
|
|
|
|
} INTERNET_CERTIFICATE_INFO, * LPINTERNET_CERTIFICATE_INFO;
|
|
|
|
|
|
//
|
|
// INTERNET_BUFFERS - combines headers and data. May be chained for e.g. file
|
|
// upload or scatter/gather operations. For chunked read/write, lpcszHeader
|
|
// contains the chunked-ext
|
|
//
|
|
|
|
typedef struct _INTERNET_BUFFERSA {
|
|
DWORD dwStructSize; // used for API versioning. Set to sizeof(INTERNET_BUFFERS)
|
|
struct _INTERNET_BUFFERSA * Next; // chain of buffers
|
|
LPCSTR lpcszHeader; // pointer to headers (may be NULL)
|
|
DWORD dwHeadersLength; // length of headers if not NULL
|
|
DWORD dwHeadersTotal; // size of headers if not enough buffer
|
|
LPVOID lpvBuffer; // pointer to data buffer (may be NULL)
|
|
DWORD dwBufferLength; // length of data buffer if not NULL
|
|
DWORD dwBufferTotal; // total size of chunk, or content-length if not chunked
|
|
DWORD dwOffsetLow; // used for read-ranges (only used in HttpSendRequest2)
|
|
DWORD dwOffsetHigh;
|
|
} INTERNET_BUFFERSA, * LPINTERNET_BUFFERSA;
|
|
typedef struct _INTERNET_BUFFERSW {
|
|
DWORD dwStructSize; // used for API versioning. Set to sizeof(INTERNET_BUFFERS)
|
|
struct _INTERNET_BUFFERSW * Next; // chain of buffers
|
|
LPCWSTR lpcszHeader; // pointer to headers (may be NULL)
|
|
DWORD dwHeadersLength; // length of headers if not NULL
|
|
DWORD dwHeadersTotal; // size of headers if not enough buffer
|
|
LPVOID lpvBuffer; // pointer to data buffer (may be NULL)
|
|
DWORD dwBufferLength; // length of data buffer if not NULL
|
|
DWORD dwBufferTotal; // total size of chunk, or content-length if not chunked
|
|
DWORD dwOffsetLow; // used for read-ranges (only used in HttpSendRequest2)
|
|
DWORD dwOffsetHigh;
|
|
} INTERNET_BUFFERSW, * LPINTERNET_BUFFERSW;
|
|
#ifdef UNICODE
|
|
typedef INTERNET_BUFFERSW INTERNET_BUFFERS;
|
|
typedef LPINTERNET_BUFFERSW LPINTERNET_BUFFERS;
|
|
#else
|
|
typedef INTERNET_BUFFERSA INTERNET_BUFFERS;
|
|
typedef LPINTERNET_BUFFERSA LPINTERNET_BUFFERS;
|
|
#endif // UNICODE
|
|
|
|
//
|
|
// prototypes
|
|
//
|
|
|
|
BOOLAPI
|
|
InternetTimeFromSystemTime(
|
|
IN CONST SYSTEMTIME *pst, // input GMT time
|
|
IN DWORD dwRFC, // RFC format
|
|
OUT LPSTR lpszTime, // output string buffer
|
|
IN DWORD cbTime // output buffer size
|
|
);
|
|
|
|
//
|
|
// constants for InternetTimeFromSystemTime
|
|
//
|
|
|
|
#define INTERNET_RFC1123_FORMAT 0
|
|
#define INTERNET_RFC1123_BUFSIZE 30
|
|
|
|
BOOLAPI
|
|
InternetTimeToSystemTime(
|
|
IN LPCSTR lpszTime, // NULL terminated string
|
|
OUT SYSTEMTIME *pst, // output in GMT time
|
|
IN DWORD dwReserved
|
|
);
|
|
|
|
|
|
BOOLAPI
|
|
InternetCrackUrlA(
|
|
IN LPCSTR lpszUrl,
|
|
IN DWORD dwUrlLength,
|
|
IN DWORD dwFlags,
|
|
IN OUT LPURL_COMPONENTSA lpUrlComponents
|
|
);
|
|
BOOLAPI
|
|
InternetCrackUrlW(
|
|
IN LPCWSTR lpszUrl,
|
|
IN DWORD dwUrlLength,
|
|
IN DWORD dwFlags,
|
|
IN OUT LPURL_COMPONENTSW lpUrlComponents
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetCrackUrl InternetCrackUrlW
|
|
#else
|
|
#define InternetCrackUrl InternetCrackUrlA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetCreateUrlA(
|
|
IN LPURL_COMPONENTSA lpUrlComponents,
|
|
IN DWORD dwFlags,
|
|
OUT LPSTR lpszUrl,
|
|
IN OUT LPDWORD lpdwUrlLength
|
|
);
|
|
BOOLAPI
|
|
InternetCreateUrlW(
|
|
IN LPURL_COMPONENTSW lpUrlComponents,
|
|
IN DWORD dwFlags,
|
|
OUT LPWSTR lpszUrl,
|
|
IN OUT LPDWORD lpdwUrlLength
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetCreateUrl InternetCreateUrlW
|
|
#else
|
|
#define InternetCreateUrl InternetCreateUrlA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetCanonicalizeUrlA(
|
|
IN LPCSTR lpszUrl,
|
|
OUT LPSTR lpszBuffer,
|
|
IN OUT LPDWORD lpdwBufferLength,
|
|
IN DWORD dwFlags
|
|
);
|
|
BOOLAPI
|
|
InternetCanonicalizeUrlW(
|
|
IN LPCWSTR lpszUrl,
|
|
OUT LPWSTR lpszBuffer,
|
|
IN OUT LPDWORD lpdwBufferLength,
|
|
IN DWORD dwFlags
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetCanonicalizeUrl InternetCanonicalizeUrlW
|
|
#else
|
|
#define InternetCanonicalizeUrl InternetCanonicalizeUrlA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetCombineUrlA(
|
|
IN LPCSTR lpszBaseUrl,
|
|
IN LPCSTR lpszRelativeUrl,
|
|
OUT LPSTR lpszBuffer,
|
|
IN OUT LPDWORD lpdwBufferLength,
|
|
IN DWORD dwFlags
|
|
);
|
|
BOOLAPI
|
|
InternetCombineUrlW(
|
|
IN LPCWSTR lpszBaseUrl,
|
|
IN LPCWSTR lpszRelativeUrl,
|
|
OUT LPWSTR lpszBuffer,
|
|
IN OUT LPDWORD lpdwBufferLength,
|
|
IN DWORD dwFlags
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetCombineUrl InternetCombineUrlW
|
|
#else
|
|
#define InternetCombineUrl InternetCombineUrlA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// flags for InternetCrackUrl() and InternetCreateUrl()
|
|
//
|
|
|
|
#define ICU_ESCAPE 0x80000000 // (un)escape URL characters
|
|
#define ICU_USERNAME 0x40000000 // use internal username & password
|
|
|
|
//
|
|
// flags for InternetCanonicalizeUrl() and InternetCombineUrl()
|
|
//
|
|
|
|
#define ICU_NO_ENCODE 0x20000000 // Don't convert unsafe characters to escape sequence
|
|
#define ICU_DECODE 0x10000000 // Convert %XX escape sequences to characters
|
|
#define ICU_NO_META 0x08000000 // Don't convert .. etc. meta path sequences
|
|
#define ICU_ENCODE_SPACES_ONLY 0x04000000 // Encode spaces only
|
|
#define ICU_BROWSER_MODE 0x02000000 // Special encode/decode rules for browser
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
InternetOpenA(
|
|
IN LPCSTR lpszAgent,
|
|
IN DWORD dwAccessType,
|
|
IN LPCSTR lpszProxy OPTIONAL,
|
|
IN LPCSTR lpszProxyBypass OPTIONAL,
|
|
IN DWORD dwFlags
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
InternetOpenW(
|
|
IN LPCWSTR lpszAgent,
|
|
IN DWORD dwAccessType,
|
|
IN LPCWSTR lpszProxy OPTIONAL,
|
|
IN LPCWSTR lpszProxyBypass OPTIONAL,
|
|
IN DWORD dwFlags
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetOpen InternetOpenW
|
|
#else
|
|
#define InternetOpen InternetOpenA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// access types for InternetOpen()
|
|
//
|
|
|
|
#define INTERNET_OPEN_TYPE_PRECONFIG 0 // use registry configuration
|
|
#define INTERNET_OPEN_TYPE_DIRECT 1 // direct to net
|
|
#define INTERNET_OPEN_TYPE_PROXY 3 // via named proxy
|
|
#define INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY 4 // prevent using java/script/INS
|
|
|
|
//
|
|
// old names for access types
|
|
//
|
|
|
|
#define PRE_CONFIG_INTERNET_ACCESS INTERNET_OPEN_TYPE_PRECONFIG
|
|
#define LOCAL_INTERNET_ACCESS INTERNET_OPEN_TYPE_DIRECT
|
|
#define CERN_PROXY_INTERNET_ACCESS INTERNET_OPEN_TYPE_PROXY
|
|
|
|
BOOLAPI
|
|
InternetCloseHandle(
|
|
IN HINTERNET hInternet
|
|
);
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
InternetConnectA(
|
|
IN HINTERNET hInternet,
|
|
IN LPCSTR lpszServerName,
|
|
IN INTERNET_PORT nServerPort,
|
|
IN LPCSTR lpszUserName OPTIONAL,
|
|
IN LPCSTR lpszPassword OPTIONAL,
|
|
IN DWORD dwService,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
InternetConnectW(
|
|
IN HINTERNET hInternet,
|
|
IN LPCWSTR lpszServerName,
|
|
IN INTERNET_PORT nServerPort,
|
|
IN LPCWSTR lpszUserName OPTIONAL,
|
|
IN LPCWSTR lpszPassword OPTIONAL,
|
|
IN DWORD dwService,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetConnect InternetConnectW
|
|
#else
|
|
#define InternetConnect InternetConnectA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// service types for InternetConnect()
|
|
//
|
|
|
|
#define INTERNET_SERVICE_URL 0
|
|
#define INTERNET_SERVICE_FTP 1
|
|
#define INTERNET_SERVICE_GOPHER 2
|
|
#define INTERNET_SERVICE_HTTP 3
|
|
|
|
//
|
|
// InternetConnectUrl() - a macro which allows you to specify an URL instead of
|
|
// the component parts to InternetConnect(). If any API which uses the returned
|
|
// connect handle specifies a NULL path then the URL-path part of the URL
|
|
// specified in InternetConnectUrl() will be used
|
|
//
|
|
|
|
#define InternetConnectUrl(hInternet, lpszUrl, dwFlags, dwContext) \
|
|
InternetConnect(hInternet, \
|
|
lpszUrl, \
|
|
INTERNET_INVALID_PORT_NUMBER, \
|
|
NULL, \
|
|
NULL, \
|
|
INTERNET_SERVICE_URL, \
|
|
dwFlags, \
|
|
dwContext \
|
|
)
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
InternetOpenUrlA(
|
|
IN HINTERNET hInternet,
|
|
IN LPCSTR lpszUrl,
|
|
IN LPCSTR lpszHeaders OPTIONAL,
|
|
IN DWORD dwHeadersLength,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
InternetOpenUrlW(
|
|
IN HINTERNET hInternet,
|
|
IN LPCWSTR lpszUrl,
|
|
IN LPCWSTR lpszHeaders OPTIONAL,
|
|
IN DWORD dwHeadersLength,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetOpenUrl InternetOpenUrlW
|
|
#else
|
|
#define InternetOpenUrl InternetOpenUrlA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetReadFile(
|
|
IN HINTERNET hFile,
|
|
IN LPVOID lpBuffer,
|
|
IN DWORD dwNumberOfBytesToRead,
|
|
OUT LPDWORD lpdwNumberOfBytesRead
|
|
);
|
|
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetReadFileExA(
|
|
IN HINTERNET hFile,
|
|
OUT LPINTERNET_BUFFERSA lpBuffersOut,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetReadFileExW(
|
|
IN HINTERNET hFile,
|
|
OUT LPINTERNET_BUFFERSW lpBuffersOut,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetReadFileEx InternetReadFileExW
|
|
#else
|
|
#define InternetReadFileEx InternetReadFileExA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// flags for InternetReadFileEx()
|
|
//
|
|
|
|
#define IRF_ASYNC WININET_API_FLAG_ASYNC
|
|
#define IRF_SYNC WININET_API_FLAG_SYNC
|
|
#define IRF_USE_CONTEXT WININET_API_FLAG_USE_CONTEXT
|
|
#define IRF_NO_WAIT 0x00000008
|
|
|
|
INTERNETAPI
|
|
DWORD
|
|
WINAPI
|
|
InternetSetFilePointer(
|
|
IN HINTERNET hFile,
|
|
IN LONG lDistanceToMove,
|
|
IN PVOID pReserved,
|
|
IN DWORD dwMoveMethod,
|
|
IN DWORD dwContext
|
|
);
|
|
|
|
BOOLAPI
|
|
InternetWriteFile(
|
|
IN HINTERNET hFile,
|
|
IN LPCVOID lpBuffer,
|
|
IN DWORD dwNumberOfBytesToWrite,
|
|
OUT LPDWORD lpdwNumberOfBytesWritten
|
|
);
|
|
|
|
|
|
BOOLAPI
|
|
InternetQueryDataAvailable(
|
|
IN HINTERNET hFile,
|
|
OUT LPDWORD lpdwNumberOfBytesAvailable OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
|
|
BOOLAPI
|
|
InternetFindNextFileA(
|
|
IN HINTERNET hFind,
|
|
OUT LPVOID lpvFindData
|
|
);
|
|
BOOLAPI
|
|
InternetFindNextFileW(
|
|
IN HINTERNET hFind,
|
|
OUT LPVOID lpvFindData
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetFindNextFile InternetFindNextFileW
|
|
#else
|
|
#define InternetFindNextFile InternetFindNextFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetQueryOptionA(
|
|
IN HINTERNET hInternet OPTIONAL,
|
|
IN DWORD dwOption,
|
|
OUT LPVOID lpBuffer OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength
|
|
);
|
|
BOOLAPI
|
|
InternetQueryOptionW(
|
|
IN HINTERNET hInternet OPTIONAL,
|
|
IN DWORD dwOption,
|
|
OUT LPVOID lpBuffer OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetQueryOption InternetQueryOptionW
|
|
#else
|
|
#define InternetQueryOption InternetQueryOptionA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetSetOptionA(
|
|
IN HINTERNET hInternet OPTIONAL,
|
|
IN DWORD dwOption,
|
|
IN LPVOID lpBuffer,
|
|
IN DWORD dwBufferLength
|
|
);
|
|
BOOLAPI
|
|
InternetSetOptionW(
|
|
IN HINTERNET hInternet OPTIONAL,
|
|
IN DWORD dwOption,
|
|
IN LPVOID lpBuffer,
|
|
IN DWORD dwBufferLength
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetSetOption InternetSetOptionW
|
|
#else
|
|
#define InternetSetOption InternetSetOptionA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetSetOptionExA(
|
|
IN HINTERNET hInternet OPTIONAL,
|
|
IN DWORD dwOption,
|
|
IN LPVOID lpBuffer,
|
|
IN DWORD dwBufferLength,
|
|
IN DWORD dwFlags
|
|
);
|
|
BOOLAPI
|
|
InternetSetOptionExW(
|
|
IN HINTERNET hInternet OPTIONAL,
|
|
IN DWORD dwOption,
|
|
IN LPVOID lpBuffer,
|
|
IN DWORD dwBufferLength,
|
|
IN DWORD dwFlags
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetSetOptionEx InternetSetOptionExW
|
|
#else
|
|
#define InternetSetOptionEx InternetSetOptionExA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetLockRequestFile(
|
|
IN HINTERNET hInternet,
|
|
OUT HANDLE * lphLockRequestInfo
|
|
);
|
|
|
|
BOOLAPI
|
|
InternetUnlockRequestFile(
|
|
IN HANDLE hLockRequestInfo
|
|
);
|
|
|
|
//
|
|
// flags for InternetSetOptionEx()
|
|
//
|
|
|
|
#define ISO_GLOBAL 0x00000001 // modify option globally
|
|
#define ISO_REGISTRY 0x00000002 // write option to registry (where applicable)
|
|
|
|
#define ISO_VALID_FLAGS (ISO_GLOBAL | ISO_REGISTRY)
|
|
|
|
//
|
|
// options manifests for Internet{Query|Set}Option
|
|
//
|
|
|
|
#define INTERNET_OPTION_CALLBACK 1
|
|
#define INTERNET_OPTION_CONNECT_TIMEOUT 2
|
|
#define INTERNET_OPTION_CONNECT_RETRIES 3
|
|
#define INTERNET_OPTION_CONNECT_BACKOFF 4
|
|
#define INTERNET_OPTION_SEND_TIMEOUT 5
|
|
#define INTERNET_OPTION_CONTROL_SEND_TIMEOUT INTERNET_OPTION_SEND_TIMEOUT
|
|
#define INTERNET_OPTION_RECEIVE_TIMEOUT 6
|
|
#define INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT INTERNET_OPTION_RECEIVE_TIMEOUT
|
|
#define INTERNET_OPTION_DATA_SEND_TIMEOUT 7
|
|
#define INTERNET_OPTION_DATA_RECEIVE_TIMEOUT 8
|
|
#define INTERNET_OPTION_HANDLE_TYPE 9
|
|
#define INTERNET_OPTION_LISTEN_TIMEOUT 11
|
|
#define INTERNET_OPTION_READ_BUFFER_SIZE 12
|
|
#define INTERNET_OPTION_WRITE_BUFFER_SIZE 13
|
|
|
|
#define INTERNET_OPTION_ASYNC_ID 15
|
|
#define INTERNET_OPTION_ASYNC_PRIORITY 16
|
|
|
|
#define INTERNET_OPTION_PARENT_HANDLE 21
|
|
#define INTERNET_OPTION_KEEP_CONNECTION 22
|
|
#define INTERNET_OPTION_REQUEST_FLAGS 23
|
|
#define INTERNET_OPTION_EXTENDED_ERROR 24
|
|
|
|
#define INTERNET_OPTION_OFFLINE_MODE 26
|
|
#define INTERNET_OPTION_CACHE_STREAM_HANDLE 27
|
|
#define INTERNET_OPTION_USERNAME 28
|
|
#define INTERNET_OPTION_PASSWORD 29
|
|
#define INTERNET_OPTION_ASYNC 30
|
|
#define INTERNET_OPTION_SECURITY_FLAGS 31
|
|
#define INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT 32
|
|
#define INTERNET_OPTION_DATAFILE_NAME 33
|
|
#define INTERNET_OPTION_URL 34
|
|
#define INTERNET_OPTION_SECURITY_CERTIFICATE 35
|
|
#define INTERNET_OPTION_SECURITY_KEY_BITNESS 36
|
|
#define INTERNET_OPTION_REFRESH 37
|
|
#define INTERNET_OPTION_PROXY 38
|
|
#define INTERNET_OPTION_SETTINGS_CHANGED 39
|
|
#define INTERNET_OPTION_VERSION 40
|
|
#define INTERNET_OPTION_USER_AGENT 41
|
|
#define INTERNET_OPTION_END_BROWSER_SESSION 42
|
|
#define INTERNET_OPTION_PROXY_USERNAME 43
|
|
#define INTERNET_OPTION_PROXY_PASSWORD 44
|
|
#define INTERNET_OPTION_CONTEXT_VALUE 45
|
|
#define INTERNET_OPTION_CONNECT_LIMIT 46
|
|
#define INTERNET_OPTION_SECURITY_SELECT_CLIENT_CERT 47
|
|
#define INTERNET_OPTION_POLICY 48
|
|
#define INTERNET_OPTION_DISCONNECTED_TIMEOUT 49
|
|
#define INTERNET_OPTION_CONNECTED_STATE 50
|
|
#define INTERNET_OPTION_IDLE_STATE 51
|
|
#define INTERNET_OPTION_OFFLINE_SEMANTICS 52
|
|
#define INTERNET_OPTION_SECONDARY_CACHE_KEY 53
|
|
#define INTERNET_OPTION_CALLBACK_FILTER 54
|
|
#define INTERNET_OPTION_CONNECT_TIME 55
|
|
#define INTERNET_OPTION_SEND_THROUGHPUT 56
|
|
#define INTERNET_OPTION_RECEIVE_THROUGHPUT 57
|
|
#define INTERNET_OPTION_REQUEST_PRIORITY 58
|
|
#define INTERNET_OPTION_HTTP_VERSION 59
|
|
#define INTERNET_OPTION_RESET_URLCACHE_SESSION 60
|
|
#define INTERNET_OPTION_ERROR_MASK 62
|
|
|
|
#define INTERNET_FIRST_OPTION INTERNET_OPTION_CALLBACK
|
|
#define INTERNET_LAST_OPTION INTERNET_OPTION_ERROR_MASK
|
|
|
|
|
|
//
|
|
// values for INTERNET_OPTION_PRIORITY
|
|
//
|
|
|
|
#define INTERNET_PRIORITY_FOREGROUND 1000
|
|
|
|
//
|
|
// handle types
|
|
//
|
|
|
|
#define INTERNET_HANDLE_TYPE_INTERNET 1
|
|
#define INTERNET_HANDLE_TYPE_CONNECT_FTP 2
|
|
#define INTERNET_HANDLE_TYPE_CONNECT_GOPHER 3
|
|
#define INTERNET_HANDLE_TYPE_CONNECT_HTTP 4
|
|
#define INTERNET_HANDLE_TYPE_FTP_FIND 5
|
|
#define INTERNET_HANDLE_TYPE_FTP_FIND_HTML 6
|
|
#define INTERNET_HANDLE_TYPE_FTP_FILE 7
|
|
#define INTERNET_HANDLE_TYPE_FTP_FILE_HTML 8
|
|
#define INTERNET_HANDLE_TYPE_GOPHER_FIND 9
|
|
#define INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML 10
|
|
#define INTERNET_HANDLE_TYPE_GOPHER_FILE 11
|
|
#define INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML 12
|
|
#define INTERNET_HANDLE_TYPE_HTTP_REQUEST 13
|
|
|
|
//
|
|
// values for INTERNET_OPTION_SECURITY_FLAGS
|
|
//
|
|
|
|
// query only
|
|
#define SECURITY_FLAG_SECURE 0x00000001 // can query only
|
|
#define SECURITY_FLAG_STRENGTH_WEAK 0x10000000
|
|
#define SECURITY_FLAG_STRENGTH_MEDIUM 0x40000000
|
|
#define SECURITY_FLAG_STRENGTH_STRONG 0x20000000
|
|
#define SECURITY_FLAG_UNKNOWNBIT 0x80000000
|
|
#define SECURITY_FLAG_NORMALBITNESS SECURITY_FLAG_STRENGTH_WEAK
|
|
|
|
|
|
|
|
// The following are unused
|
|
#define SECURITY_FLAG_SSL 0x00000002
|
|
#define SECURITY_FLAG_SSL3 0x00000004
|
|
#define SECURITY_FLAG_PCT 0x00000008
|
|
#define SECURITY_FLAG_PCT4 0x00000010
|
|
#define SECURITY_FLAG_IETFSSL4 0x00000020
|
|
|
|
// The following are for backwards compatability only.
|
|
#define SECURITY_FLAG_40BIT SECURITY_FLAG_STRENGTH_WEAK
|
|
#define SECURITY_FLAG_128BIT SECURITY_FLAG_STRENGTH_STRONG
|
|
#define SECURITY_FLAG_56BIT SECURITY_FLAG_STRENGTH_MEDIUM
|
|
|
|
|
|
// setable flags
|
|
#define SECURITY_FLAG_IGNORE_REVOCATION 0x00000080
|
|
#define SECURITY_FLAG_IGNORE_UNKNOWN_CA 0x00000100
|
|
#define SECURITY_FLAG_IGNORE_WRONG_USAGE 0x00000200
|
|
|
|
#define SECURITY_FLAG_IGNORE_CERT_CN_INVALID INTERNET_FLAG_IGNORE_CERT_CN_INVALID
|
|
#define SECURITY_FLAG_IGNORE_CERT_DATE_INVALID INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
|
|
|
|
|
|
#define SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
|
|
#define SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
|
|
|
|
|
|
|
|
#define SECURITY_SET_MASK (SECURITY_FLAG_IGNORE_REVOCATION |\
|
|
SECURITY_FLAG_IGNORE_UNKNOWN_CA |\
|
|
SECURITY_FLAG_IGNORE_CERT_CN_INVALID |\
|
|
SECURITY_FLAG_IGNORE_CERT_DATE_INVALID |\
|
|
SECURITY_FLAG_IGNORE_WRONG_USAGE)
|
|
|
|
|
|
|
|
BOOLAPI
|
|
InternetGetLastResponseInfoA(
|
|
OUT LPDWORD lpdwError,
|
|
OUT LPSTR lpszBuffer OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength
|
|
);
|
|
BOOLAPI
|
|
InternetGetLastResponseInfoW(
|
|
OUT LPDWORD lpdwError,
|
|
OUT LPWSTR lpszBuffer OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetGetLastResponseInfo InternetGetLastResponseInfoW
|
|
#else
|
|
#define InternetGetLastResponseInfo InternetGetLastResponseInfoA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// callback function for InternetSetStatusCallback
|
|
//
|
|
|
|
typedef
|
|
VOID
|
|
(CALLBACK * INTERNET_STATUS_CALLBACK)(
|
|
IN HINTERNET hInternet,
|
|
IN DWORD dwContext,
|
|
IN DWORD dwInternetStatus,
|
|
IN LPVOID lpvStatusInformation OPTIONAL,
|
|
IN DWORD dwStatusInformationLength
|
|
);
|
|
|
|
typedef INTERNET_STATUS_CALLBACK * LPINTERNET_STATUS_CALLBACK;
|
|
|
|
INTERNETAPI
|
|
INTERNET_STATUS_CALLBACK
|
|
WINAPI
|
|
InternetSetStatusCallback(
|
|
IN HINTERNET hInternet,
|
|
IN INTERNET_STATUS_CALLBACK lpfnInternetCallback
|
|
);
|
|
|
|
//
|
|
// status manifests for Internet status callback
|
|
//
|
|
|
|
#define INTERNET_STATUS_RESOLVING_NAME 10
|
|
#define INTERNET_STATUS_NAME_RESOLVED 11
|
|
#define INTERNET_STATUS_CONNECTING_TO_SERVER 20
|
|
#define INTERNET_STATUS_CONNECTED_TO_SERVER 21
|
|
#define INTERNET_STATUS_SENDING_REQUEST 30
|
|
#define INTERNET_STATUS_REQUEST_SENT 31
|
|
#define INTERNET_STATUS_RECEIVING_RESPONSE 40
|
|
#define INTERNET_STATUS_RESPONSE_RECEIVED 41
|
|
#define INTERNET_STATUS_CTL_RESPONSE_RECEIVED 42
|
|
#define INTERNET_STATUS_PREFETCH 43
|
|
#define INTERNET_STATUS_CLOSING_CONNECTION 50
|
|
#define INTERNET_STATUS_CONNECTION_CLOSED 51
|
|
#define INTERNET_STATUS_HANDLE_CREATED 60
|
|
#define INTERNET_STATUS_HANDLE_CLOSING 70
|
|
#define INTERNET_STATUS_REQUEST_COMPLETE 100
|
|
#define INTERNET_STATUS_REDIRECT 110
|
|
#define INTERNET_STATUS_INTERMEDIATE_RESPONSE 120
|
|
#define INTERNET_STATUS_STATE_CHANGE 200
|
|
|
|
//
|
|
// the following can be indicated in a state change notification:
|
|
//
|
|
|
|
#define INTERNET_STATE_CONNECTED 0x00000001 // connected state (mutually exclusive with disconnected)
|
|
#define INTERNET_STATE_DISCONNECTED 0x00000002 // disconnected from network
|
|
#define INTERNET_STATE_DISCONNECTED_BY_USER 0x00000010 // disconnected by user request
|
|
#define INTERNET_STATE_IDLE 0x00000100 // no network requests being made (by Wininet)
|
|
#define INTERNET_STATE_BUSY 0x00000200 // network requests being made (by Wininet)
|
|
|
|
|
|
//
|
|
// if the following value is returned by InternetSetStatusCallback, then
|
|
// probably an invalid (non-code) address was supplied for the callback
|
|
//
|
|
|
|
#define INTERNET_INVALID_STATUS_CALLBACK ((INTERNET_STATUS_CALLBACK)(-1L))
|
|
|
|
//
|
|
// FTP
|
|
//
|
|
|
|
//
|
|
// manifests
|
|
//
|
|
|
|
#define FTP_TRANSFER_TYPE_UNKNOWN 0x00000000
|
|
#define FTP_TRANSFER_TYPE_ASCII 0x00000001
|
|
#define FTP_TRANSFER_TYPE_BINARY 0x00000002
|
|
|
|
#define FTP_TRANSFER_TYPE_MASK (FTP_TRANSFER_TYPE_ASCII | FTP_TRANSFER_TYPE_BINARY)
|
|
|
|
//
|
|
// prototypes
|
|
//
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
FtpFindFirstFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszSearchFile OPTIONAL,
|
|
OUT LPWIN32_FIND_DATA lpFindFileData OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
FtpFindFirstFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszSearchFile OPTIONAL,
|
|
OUT LPWIN32_FIND_DATA lpFindFileData OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpFindFirstFile FtpFindFirstFileW
|
|
#else
|
|
#define FtpFindFirstFile FtpFindFirstFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpGetFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszRemoteFile,
|
|
IN LPCSTR lpszNewFile,
|
|
IN BOOL fFailIfExists,
|
|
IN DWORD dwFlagsAndAttributes,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
BOOLAPI
|
|
FtpGetFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszRemoteFile,
|
|
IN LPCWSTR lpszNewFile,
|
|
IN BOOL fFailIfExists,
|
|
IN DWORD dwFlagsAndAttributes,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpGetFile FtpGetFileW
|
|
#else
|
|
#define FtpGetFile FtpGetFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpPutFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszLocalFile,
|
|
IN LPCSTR lpszNewRemoteFile,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
BOOLAPI
|
|
FtpPutFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszLocalFile,
|
|
IN LPCWSTR lpszNewRemoteFile,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpPutFile FtpPutFileW
|
|
#else
|
|
#define FtpPutFile FtpPutFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpDeleteFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszFileName
|
|
);
|
|
BOOLAPI
|
|
FtpDeleteFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszFileName
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpDeleteFile FtpDeleteFileW
|
|
#else
|
|
#define FtpDeleteFile FtpDeleteFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpRenameFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszExisting,
|
|
IN LPCSTR lpszNew
|
|
);
|
|
BOOLAPI
|
|
FtpRenameFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszExisting,
|
|
IN LPCWSTR lpszNew
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpRenameFile FtpRenameFileW
|
|
#else
|
|
#define FtpRenameFile FtpRenameFileA
|
|
#endif // !UNICODE
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
FtpOpenFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszFileName,
|
|
IN DWORD dwAccess,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
FtpOpenFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszFileName,
|
|
IN DWORD dwAccess,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpOpenFile FtpOpenFileW
|
|
#else
|
|
#define FtpOpenFile FtpOpenFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpCreateDirectoryA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszDirectory
|
|
);
|
|
BOOLAPI
|
|
FtpCreateDirectoryW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszDirectory
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpCreateDirectory FtpCreateDirectoryW
|
|
#else
|
|
#define FtpCreateDirectory FtpCreateDirectoryA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpRemoveDirectoryA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszDirectory
|
|
);
|
|
BOOLAPI
|
|
FtpRemoveDirectoryW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszDirectory
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpRemoveDirectory FtpRemoveDirectoryW
|
|
#else
|
|
#define FtpRemoveDirectory FtpRemoveDirectoryA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpSetCurrentDirectoryA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszDirectory
|
|
);
|
|
BOOLAPI
|
|
FtpSetCurrentDirectoryW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszDirectory
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpSetCurrentDirectory FtpSetCurrentDirectoryW
|
|
#else
|
|
#define FtpSetCurrentDirectory FtpSetCurrentDirectoryA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FtpGetCurrentDirectoryA(
|
|
IN HINTERNET hConnect,
|
|
OUT LPSTR lpszCurrentDirectory,
|
|
IN OUT LPDWORD lpdwCurrentDirectory
|
|
);
|
|
BOOLAPI
|
|
FtpGetCurrentDirectoryW(
|
|
IN HINTERNET hConnect,
|
|
OUT LPWSTR lpszCurrentDirectory,
|
|
IN OUT LPDWORD lpdwCurrentDirectory
|
|
);
|
|
#ifdef UNICODE
|
|
#define FtpGetCurrentDirectory FtpGetCurrentDirectoryW
|
|
#else
|
|
#define FtpGetCurrentDirectory FtpGetCurrentDirectoryA
|
|
#endif // !UNICODE
|
|
|
|
|
|
//
|
|
// Gopher
|
|
//
|
|
|
|
//
|
|
// manifests
|
|
//
|
|
|
|
//
|
|
// string field lengths (in characters, not bytes)
|
|
//
|
|
|
|
#define MAX_GOPHER_DISPLAY_TEXT 128
|
|
#define MAX_GOPHER_SELECTOR_TEXT 256
|
|
#define MAX_GOPHER_HOST_NAME INTERNET_MAX_HOST_NAME_LENGTH
|
|
#define MAX_GOPHER_LOCATOR_LENGTH (1 \
|
|
+ MAX_GOPHER_DISPLAY_TEXT \
|
|
+ 1 \
|
|
+ MAX_GOPHER_SELECTOR_TEXT \
|
|
+ 1 \
|
|
+ MAX_GOPHER_HOST_NAME \
|
|
+ 1 \
|
|
+ INTERNET_MAX_PORT_NUMBER_LENGTH \
|
|
+ 1 \
|
|
+ 1 \
|
|
+ 2 \
|
|
)
|
|
|
|
//
|
|
// structures/types
|
|
//
|
|
|
|
//
|
|
// GOPHER_FIND_DATA - returns the results of a GopherFindFirstFile()/
|
|
// InternetFindNextFile() request
|
|
//
|
|
|
|
typedef struct {
|
|
CHAR DisplayString[MAX_GOPHER_DISPLAY_TEXT + 1];
|
|
DWORD GopherType; // GOPHER_TYPE_, if known
|
|
DWORD SizeLow;
|
|
DWORD SizeHigh;
|
|
FILETIME LastModificationTime;
|
|
CHAR Locator[MAX_GOPHER_LOCATOR_LENGTH + 1];
|
|
} GOPHER_FIND_DATAA, * LPGOPHER_FIND_DATAA;
|
|
typedef struct {
|
|
WCHAR DisplayString[MAX_GOPHER_DISPLAY_TEXT + 1];
|
|
DWORD GopherType; // GOPHER_TYPE_, if known
|
|
DWORD SizeLow;
|
|
DWORD SizeHigh;
|
|
FILETIME LastModificationTime;
|
|
WCHAR Locator[MAX_GOPHER_LOCATOR_LENGTH + 1];
|
|
} GOPHER_FIND_DATAW, * LPGOPHER_FIND_DATAW;
|
|
#ifdef UNICODE
|
|
typedef GOPHER_FIND_DATAW GOPHER_FIND_DATA;
|
|
typedef LPGOPHER_FIND_DATAW LPGOPHER_FIND_DATA;
|
|
#else
|
|
typedef GOPHER_FIND_DATAA GOPHER_FIND_DATA;
|
|
typedef LPGOPHER_FIND_DATAA LPGOPHER_FIND_DATA;
|
|
#endif // UNICODE
|
|
|
|
//
|
|
// manifests for GopherType
|
|
//
|
|
|
|
#define GOPHER_TYPE_TEXT_FILE 0x00000001
|
|
#define GOPHER_TYPE_DIRECTORY 0x00000002
|
|
#define GOPHER_TYPE_CSO 0x00000004
|
|
#define GOPHER_TYPE_ERROR 0x00000008
|
|
#define GOPHER_TYPE_MAC_BINHEX 0x00000010
|
|
#define GOPHER_TYPE_DOS_ARCHIVE 0x00000020
|
|
#define GOPHER_TYPE_UNIX_UUENCODED 0x00000040
|
|
#define GOPHER_TYPE_INDEX_SERVER 0x00000080
|
|
#define GOPHER_TYPE_TELNET 0x00000100
|
|
#define GOPHER_TYPE_BINARY 0x00000200
|
|
#define GOPHER_TYPE_REDUNDANT 0x00000400
|
|
#define GOPHER_TYPE_TN3270 0x00000800
|
|
#define GOPHER_TYPE_GIF 0x00001000
|
|
#define GOPHER_TYPE_IMAGE 0x00002000
|
|
#define GOPHER_TYPE_BITMAP 0x00004000
|
|
#define GOPHER_TYPE_MOVIE 0x00008000
|
|
#define GOPHER_TYPE_SOUND 0x00010000
|
|
#define GOPHER_TYPE_HTML 0x00020000
|
|
#define GOPHER_TYPE_PDF 0x00040000
|
|
#define GOPHER_TYPE_CALENDAR 0x00080000
|
|
#define GOPHER_TYPE_INLINE 0x00100000
|
|
#define GOPHER_TYPE_UNKNOWN 0x20000000
|
|
#define GOPHER_TYPE_ASK 0x40000000
|
|
#define GOPHER_TYPE_GOPHER_PLUS 0x80000000
|
|
|
|
//
|
|
// gopher type macros
|
|
//
|
|
|
|
#define IS_GOPHER_FILE(type) (BOOL)(((type) & GOPHER_TYPE_FILE_MASK) ? TRUE : FALSE)
|
|
#define IS_GOPHER_DIRECTORY(type) (BOOL)(((type) & GOPHER_TYPE_DIRECTORY) ? TRUE : FALSE)
|
|
#define IS_GOPHER_PHONE_SERVER(type) (BOOL)(((type) & GOPHER_TYPE_CSO) ? TRUE : FALSE)
|
|
#define IS_GOPHER_ERROR(type) (BOOL)(((type) & GOPHER_TYPE_ERROR) ? TRUE : FALSE)
|
|
#define IS_GOPHER_INDEX_SERVER(type) (BOOL)(((type) & GOPHER_TYPE_INDEX_SERVER) ? TRUE : FALSE)
|
|
#define IS_GOPHER_TELNET_SESSION(type) (BOOL)(((type) & GOPHER_TYPE_TELNET) ? TRUE : FALSE)
|
|
#define IS_GOPHER_BACKUP_SERVER(type) (BOOL)(((type) & GOPHER_TYPE_REDUNDANT) ? TRUE : FALSE)
|
|
#define IS_GOPHER_TN3270_SESSION(type) (BOOL)(((type) & GOPHER_TYPE_TN3270) ? TRUE : FALSE)
|
|
#define IS_GOPHER_ASK(type) (BOOL)(((type) & GOPHER_TYPE_ASK) ? TRUE : FALSE)
|
|
#define IS_GOPHER_PLUS(type) (BOOL)(((type) & GOPHER_TYPE_GOPHER_PLUS) ? TRUE : FALSE)
|
|
|
|
#define IS_GOPHER_TYPE_KNOWN(type) (BOOL)(((type) & GOPHER_TYPE_UNKNOWN) ? FALSE : TRUE)
|
|
|
|
//
|
|
// GOPHER_TYPE_FILE_MASK - use this to determine if a locator identifies a
|
|
// (known) file type
|
|
//
|
|
|
|
#define GOPHER_TYPE_FILE_MASK (GOPHER_TYPE_TEXT_FILE \
|
|
| GOPHER_TYPE_MAC_BINHEX \
|
|
| GOPHER_TYPE_DOS_ARCHIVE \
|
|
| GOPHER_TYPE_UNIX_UUENCODED \
|
|
| GOPHER_TYPE_BINARY \
|
|
| GOPHER_TYPE_GIF \
|
|
| GOPHER_TYPE_IMAGE \
|
|
| GOPHER_TYPE_BITMAP \
|
|
| GOPHER_TYPE_MOVIE \
|
|
| GOPHER_TYPE_SOUND \
|
|
| GOPHER_TYPE_HTML \
|
|
| GOPHER_TYPE_PDF \
|
|
| GOPHER_TYPE_CALENDAR \
|
|
| GOPHER_TYPE_INLINE \
|
|
)
|
|
|
|
//
|
|
// structured gopher attributes (as defined in gopher+ protocol document)
|
|
//
|
|
|
|
typedef struct {
|
|
LPCTSTR Comment;
|
|
LPCTSTR EmailAddress;
|
|
} GOPHER_ADMIN_ATTRIBUTE_TYPE, * LPGOPHER_ADMIN_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
FILETIME DateAndTime;
|
|
} GOPHER_MOD_DATE_ATTRIBUTE_TYPE, * LPGOPHER_MOD_DATE_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
DWORD Ttl;
|
|
} GOPHER_TTL_ATTRIBUTE_TYPE, * LPGOPHER_TTL_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
INT Score;
|
|
} GOPHER_SCORE_ATTRIBUTE_TYPE, * LPGOPHER_SCORE_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
INT LowerBound;
|
|
INT UpperBound;
|
|
} GOPHER_SCORE_RANGE_ATTRIBUTE_TYPE, * LPGOPHER_SCORE_RANGE_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR Site;
|
|
} GOPHER_SITE_ATTRIBUTE_TYPE, * LPGOPHER_SITE_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR Organization;
|
|
} GOPHER_ORGANIZATION_ATTRIBUTE_TYPE, * LPGOPHER_ORGANIZATION_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR Location;
|
|
} GOPHER_LOCATION_ATTRIBUTE_TYPE, * LPGOPHER_LOCATION_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
INT DegreesNorth;
|
|
INT MinutesNorth;
|
|
INT SecondsNorth;
|
|
INT DegreesEast;
|
|
INT MinutesEast;
|
|
INT SecondsEast;
|
|
} GOPHER_GEOGRAPHICAL_LOCATION_ATTRIBUTE_TYPE, * LPGOPHER_GEOGRAPHICAL_LOCATION_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
INT Zone;
|
|
} GOPHER_TIMEZONE_ATTRIBUTE_TYPE, * LPGOPHER_TIMEZONE_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR Provider;
|
|
} GOPHER_PROVIDER_ATTRIBUTE_TYPE, * LPGOPHER_PROVIDER_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR Version;
|
|
} GOPHER_VERSION_ATTRIBUTE_TYPE, * LPGOPHER_VERSION_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR ShortAbstract;
|
|
LPCTSTR AbstractFile;
|
|
} GOPHER_ABSTRACT_ATTRIBUTE_TYPE, * LPGOPHER_ABSTRACT_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR ContentType;
|
|
LPCTSTR Language;
|
|
DWORD Size;
|
|
} GOPHER_VIEW_ATTRIBUTE_TYPE, * LPGOPHER_VIEW_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
BOOL TreeWalk;
|
|
} GOPHER_VERONICA_ATTRIBUTE_TYPE, * LPGOPHER_VERONICA_ATTRIBUTE_TYPE;
|
|
|
|
typedef struct {
|
|
LPCTSTR QuestionType;
|
|
LPCTSTR QuestionText;
|
|
} GOPHER_ASK_ATTRIBUTE_TYPE, * LPGOPHER_ASK_ATTRIBUTE_TYPE;
|
|
|
|
//
|
|
// GOPHER_UNKNOWN_ATTRIBUTE_TYPE - this is returned if we retrieve an attribute
|
|
// that is not specified in the current gopher/gopher+ documentation. It is up
|
|
// to the application to parse the information
|
|
//
|
|
|
|
typedef struct {
|
|
LPCTSTR Text;
|
|
} GOPHER_UNKNOWN_ATTRIBUTE_TYPE, * LPGOPHER_UNKNOWN_ATTRIBUTE_TYPE;
|
|
|
|
//
|
|
// GOPHER_ATTRIBUTE_TYPE - returned in the user's buffer when an enumerated
|
|
// GopherGetAttribute call is made
|
|
//
|
|
|
|
typedef struct {
|
|
DWORD CategoryId; // e.g. GOPHER_CATEGORY_ID_ADMIN
|
|
DWORD AttributeId; // e.g. GOPHER_ATTRIBUTE_ID_ADMIN
|
|
union {
|
|
GOPHER_ADMIN_ATTRIBUTE_TYPE Admin;
|
|
GOPHER_MOD_DATE_ATTRIBUTE_TYPE ModDate;
|
|
GOPHER_TTL_ATTRIBUTE_TYPE Ttl;
|
|
GOPHER_SCORE_ATTRIBUTE_TYPE Score;
|
|
GOPHER_SCORE_RANGE_ATTRIBUTE_TYPE ScoreRange;
|
|
GOPHER_SITE_ATTRIBUTE_TYPE Site;
|
|
GOPHER_ORGANIZATION_ATTRIBUTE_TYPE Organization;
|
|
GOPHER_LOCATION_ATTRIBUTE_TYPE Location;
|
|
GOPHER_GEOGRAPHICAL_LOCATION_ATTRIBUTE_TYPE GeographicalLocation;
|
|
GOPHER_TIMEZONE_ATTRIBUTE_TYPE TimeZone;
|
|
GOPHER_PROVIDER_ATTRIBUTE_TYPE Provider;
|
|
GOPHER_VERSION_ATTRIBUTE_TYPE Version;
|
|
GOPHER_ABSTRACT_ATTRIBUTE_TYPE Abstract;
|
|
GOPHER_VIEW_ATTRIBUTE_TYPE View;
|
|
GOPHER_VERONICA_ATTRIBUTE_TYPE Veronica;
|
|
GOPHER_ASK_ATTRIBUTE_TYPE Ask;
|
|
GOPHER_UNKNOWN_ATTRIBUTE_TYPE Unknown;
|
|
} AttributeType;
|
|
} GOPHER_ATTRIBUTE_TYPE, * LPGOPHER_ATTRIBUTE_TYPE;
|
|
|
|
#define MAX_GOPHER_CATEGORY_NAME 128 // arbitrary
|
|
#define MAX_GOPHER_ATTRIBUTE_NAME 128 // "
|
|
#define MIN_GOPHER_ATTRIBUTE_LENGTH 256 // "
|
|
|
|
//
|
|
// known gopher attribute categories. See below for ordinals
|
|
//
|
|
|
|
#define GOPHER_INFO_CATEGORY TEXT("+INFO")
|
|
#define GOPHER_ADMIN_CATEGORY TEXT("+ADMIN")
|
|
#define GOPHER_VIEWS_CATEGORY TEXT("+VIEWS")
|
|
#define GOPHER_ABSTRACT_CATEGORY TEXT("+ABSTRACT")
|
|
#define GOPHER_VERONICA_CATEGORY TEXT("+VERONICA")
|
|
|
|
//
|
|
// known gopher attributes. These are the attribute names as defined in the
|
|
// gopher+ protocol document
|
|
//
|
|
|
|
#define GOPHER_ADMIN_ATTRIBUTE TEXT("Admin")
|
|
#define GOPHER_MOD_DATE_ATTRIBUTE TEXT("Mod-Date")
|
|
#define GOPHER_TTL_ATTRIBUTE TEXT("TTL")
|
|
#define GOPHER_SCORE_ATTRIBUTE TEXT("Score")
|
|
#define GOPHER_RANGE_ATTRIBUTE TEXT("Score-range")
|
|
#define GOPHER_SITE_ATTRIBUTE TEXT("Site")
|
|
#define GOPHER_ORG_ATTRIBUTE TEXT("Org")
|
|
#define GOPHER_LOCATION_ATTRIBUTE TEXT("Loc")
|
|
#define GOPHER_GEOG_ATTRIBUTE TEXT("Geog")
|
|
#define GOPHER_TIMEZONE_ATTRIBUTE TEXT("TZ")
|
|
#define GOPHER_PROVIDER_ATTRIBUTE TEXT("Provider")
|
|
#define GOPHER_VERSION_ATTRIBUTE TEXT("Version")
|
|
#define GOPHER_ABSTRACT_ATTRIBUTE TEXT("Abstract")
|
|
#define GOPHER_VIEW_ATTRIBUTE TEXT("View")
|
|
#define GOPHER_TREEWALK_ATTRIBUTE TEXT("treewalk")
|
|
|
|
//
|
|
// identifiers for attribute strings
|
|
//
|
|
|
|
#define GOPHER_ATTRIBUTE_ID_BASE 0xabcccc00
|
|
|
|
#define GOPHER_CATEGORY_ID_ALL (GOPHER_ATTRIBUTE_ID_BASE + 1)
|
|
|
|
#define GOPHER_CATEGORY_ID_INFO (GOPHER_ATTRIBUTE_ID_BASE + 2)
|
|
#define GOPHER_CATEGORY_ID_ADMIN (GOPHER_ATTRIBUTE_ID_BASE + 3)
|
|
#define GOPHER_CATEGORY_ID_VIEWS (GOPHER_ATTRIBUTE_ID_BASE + 4)
|
|
#define GOPHER_CATEGORY_ID_ABSTRACT (GOPHER_ATTRIBUTE_ID_BASE + 5)
|
|
#define GOPHER_CATEGORY_ID_VERONICA (GOPHER_ATTRIBUTE_ID_BASE + 6)
|
|
#define GOPHER_CATEGORY_ID_ASK (GOPHER_ATTRIBUTE_ID_BASE + 7)
|
|
|
|
#define GOPHER_CATEGORY_ID_UNKNOWN (GOPHER_ATTRIBUTE_ID_BASE + 8)
|
|
|
|
#define GOPHER_ATTRIBUTE_ID_ALL (GOPHER_ATTRIBUTE_ID_BASE + 9)
|
|
|
|
#define GOPHER_ATTRIBUTE_ID_ADMIN (GOPHER_ATTRIBUTE_ID_BASE + 10)
|
|
#define GOPHER_ATTRIBUTE_ID_MOD_DATE (GOPHER_ATTRIBUTE_ID_BASE + 11)
|
|
#define GOPHER_ATTRIBUTE_ID_TTL (GOPHER_ATTRIBUTE_ID_BASE + 12)
|
|
#define GOPHER_ATTRIBUTE_ID_SCORE (GOPHER_ATTRIBUTE_ID_BASE + 13)
|
|
#define GOPHER_ATTRIBUTE_ID_RANGE (GOPHER_ATTRIBUTE_ID_BASE + 14)
|
|
#define GOPHER_ATTRIBUTE_ID_SITE (GOPHER_ATTRIBUTE_ID_BASE + 15)
|
|
#define GOPHER_ATTRIBUTE_ID_ORG (GOPHER_ATTRIBUTE_ID_BASE + 16)
|
|
#define GOPHER_ATTRIBUTE_ID_LOCATION (GOPHER_ATTRIBUTE_ID_BASE + 17)
|
|
#define GOPHER_ATTRIBUTE_ID_GEOG (GOPHER_ATTRIBUTE_ID_BASE + 18)
|
|
#define GOPHER_ATTRIBUTE_ID_TIMEZONE (GOPHER_ATTRIBUTE_ID_BASE + 19)
|
|
#define GOPHER_ATTRIBUTE_ID_PROVIDER (GOPHER_ATTRIBUTE_ID_BASE + 20)
|
|
#define GOPHER_ATTRIBUTE_ID_VERSION (GOPHER_ATTRIBUTE_ID_BASE + 21)
|
|
#define GOPHER_ATTRIBUTE_ID_ABSTRACT (GOPHER_ATTRIBUTE_ID_BASE + 22)
|
|
#define GOPHER_ATTRIBUTE_ID_VIEW (GOPHER_ATTRIBUTE_ID_BASE + 23)
|
|
#define GOPHER_ATTRIBUTE_ID_TREEWALK (GOPHER_ATTRIBUTE_ID_BASE + 24)
|
|
|
|
#define GOPHER_ATTRIBUTE_ID_UNKNOWN (GOPHER_ATTRIBUTE_ID_BASE + 25)
|
|
|
|
//
|
|
// prototypes
|
|
//
|
|
|
|
BOOLAPI
|
|
GopherCreateLocatorA(
|
|
IN LPCSTR lpszHost,
|
|
IN INTERNET_PORT nServerPort,
|
|
IN LPCSTR lpszDisplayString OPTIONAL,
|
|
IN LPCSTR lpszSelectorString OPTIONAL,
|
|
IN DWORD dwGopherType,
|
|
OUT LPSTR lpszLocator OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength
|
|
);
|
|
BOOLAPI
|
|
GopherCreateLocatorW(
|
|
IN LPCWSTR lpszHost,
|
|
IN INTERNET_PORT nServerPort,
|
|
IN LPCWSTR lpszDisplayString OPTIONAL,
|
|
IN LPCWSTR lpszSelectorString OPTIONAL,
|
|
IN DWORD dwGopherType,
|
|
OUT LPWSTR lpszLocator OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength
|
|
);
|
|
#ifdef UNICODE
|
|
#define GopherCreateLocator GopherCreateLocatorW
|
|
#else
|
|
#define GopherCreateLocator GopherCreateLocatorA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
GopherGetLocatorTypeA(
|
|
IN LPCSTR lpszLocator,
|
|
OUT LPDWORD lpdwGopherType
|
|
);
|
|
BOOLAPI
|
|
GopherGetLocatorTypeW(
|
|
IN LPCWSTR lpszLocator,
|
|
OUT LPDWORD lpdwGopherType
|
|
);
|
|
#ifdef UNICODE
|
|
#define GopherGetLocatorType GopherGetLocatorTypeW
|
|
#else
|
|
#define GopherGetLocatorType GopherGetLocatorTypeA
|
|
#endif // !UNICODE
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
GopherFindFirstFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszLocator OPTIONAL,
|
|
IN LPCSTR lpszSearchString OPTIONAL,
|
|
OUT LPGOPHER_FIND_DATAA lpFindData OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
GopherFindFirstFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszLocator OPTIONAL,
|
|
IN LPCWSTR lpszSearchString OPTIONAL,
|
|
OUT LPGOPHER_FIND_DATAW lpFindData OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define GopherFindFirstFile GopherFindFirstFileW
|
|
#else
|
|
#define GopherFindFirstFile GopherFindFirstFileA
|
|
#endif // !UNICODE
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
GopherOpenFileA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszLocator,
|
|
IN LPCSTR lpszView OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
GopherOpenFileW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszLocator,
|
|
IN LPCWSTR lpszView OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define GopherOpenFile GopherOpenFileW
|
|
#else
|
|
#define GopherOpenFile GopherOpenFileA
|
|
#endif // !UNICODE
|
|
|
|
typedef
|
|
BOOL
|
|
(CALLBACK * GOPHER_ATTRIBUTE_ENUMERATOR)(
|
|
LPGOPHER_ATTRIBUTE_TYPE lpAttributeInfo,
|
|
DWORD dwError
|
|
);
|
|
|
|
BOOLAPI
|
|
GopherGetAttributeA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszLocator,
|
|
IN LPCSTR lpszAttributeName OPTIONAL,
|
|
OUT LPBYTE lpBuffer,
|
|
IN DWORD dwBufferLength,
|
|
OUT LPDWORD lpdwCharactersReturned,
|
|
IN GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator OPTIONAL,
|
|
IN DWORD dwContext
|
|
);
|
|
BOOLAPI
|
|
GopherGetAttributeW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszLocator,
|
|
IN LPCWSTR lpszAttributeName OPTIONAL,
|
|
OUT LPBYTE lpBuffer,
|
|
IN DWORD dwBufferLength,
|
|
OUT LPDWORD lpdwCharactersReturned,
|
|
IN GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator OPTIONAL,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define GopherGetAttribute GopherGetAttributeW
|
|
#else
|
|
#define GopherGetAttribute GopherGetAttributeA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// HTTP
|
|
//
|
|
|
|
//
|
|
// manifests
|
|
//
|
|
|
|
//
|
|
// the default major/minor HTTP version numbers
|
|
//
|
|
|
|
#define HTTP_MAJOR_VERSION 1
|
|
#define HTTP_MINOR_VERSION 0
|
|
|
|
#define HTTP_VERSION TEXT("HTTP/1.0")
|
|
|
|
//
|
|
// HttpQueryInfo info levels. Generally, there is one info level
|
|
// for each potential RFC822/HTTP/MIME header that an HTTP server
|
|
// may send as part of a request response.
|
|
//
|
|
// The HTTP_QUERY_RAW_HEADERS info level is provided for clients
|
|
// that choose to perform their own header parsing.
|
|
//
|
|
|
|
#define HTTP_QUERY_MIME_VERSION 0
|
|
#define HTTP_QUERY_CONTENT_TYPE 1
|
|
#define HTTP_QUERY_CONTENT_TRANSFER_ENCODING 2
|
|
#define HTTP_QUERY_CONTENT_ID 3
|
|
#define HTTP_QUERY_CONTENT_DESCRIPTION 4
|
|
#define HTTP_QUERY_CONTENT_LENGTH 5
|
|
#define HTTP_QUERY_CONTENT_LANGUAGE 6
|
|
#define HTTP_QUERY_ALLOW 7
|
|
#define HTTP_QUERY_PUBLIC 8
|
|
#define HTTP_QUERY_DATE 9
|
|
#define HTTP_QUERY_EXPIRES 10
|
|
#define HTTP_QUERY_LAST_MODIFIED 11
|
|
#define HTTP_QUERY_MESSAGE_ID 12
|
|
#define HTTP_QUERY_URI 13
|
|
#define HTTP_QUERY_DERIVED_FROM 14
|
|
#define HTTP_QUERY_COST 15
|
|
#define HTTP_QUERY_LINK 16
|
|
#define HTTP_QUERY_PRAGMA 17
|
|
#define HTTP_QUERY_VERSION 18 // special: part of status line
|
|
#define HTTP_QUERY_STATUS_CODE 19 // special: part of status line
|
|
#define HTTP_QUERY_STATUS_TEXT 20 // special: part of status line
|
|
#define HTTP_QUERY_RAW_HEADERS 21 // special: all headers as ASCIIZ
|
|
#define HTTP_QUERY_RAW_HEADERS_CRLF 22 // special: all headers
|
|
#define HTTP_QUERY_CONNECTION 23
|
|
#define HTTP_QUERY_ACCEPT 24
|
|
#define HTTP_QUERY_ACCEPT_CHARSET 25
|
|
#define HTTP_QUERY_ACCEPT_ENCODING 26
|
|
#define HTTP_QUERY_ACCEPT_LANGUAGE 27
|
|
#define HTTP_QUERY_AUTHORIZATION 28
|
|
#define HTTP_QUERY_CONTENT_ENCODING 29
|
|
#define HTTP_QUERY_FORWARDED 30
|
|
#define HTTP_QUERY_FROM 31
|
|
#define HTTP_QUERY_IF_MODIFIED_SINCE 32
|
|
#define HTTP_QUERY_LOCATION 33
|
|
#define HTTP_QUERY_ORIG_URI 34
|
|
#define HTTP_QUERY_REFERER 35
|
|
#define HTTP_QUERY_RETRY_AFTER 36
|
|
#define HTTP_QUERY_SERVER 37
|
|
#define HTTP_QUERY_TITLE 38
|
|
#define HTTP_QUERY_USER_AGENT 39
|
|
#define HTTP_QUERY_WWW_AUTHENTICATE 40
|
|
#define HTTP_QUERY_PROXY_AUTHENTICATE 41
|
|
#define HTTP_QUERY_ACCEPT_RANGES 42
|
|
#define HTTP_QUERY_SET_COOKIE 43
|
|
#define HTTP_QUERY_COOKIE 44
|
|
#define HTTP_QUERY_REQUEST_METHOD 45 // special: GET/POST etc.
|
|
#define HTTP_QUERY_REFRESH 46
|
|
#define HTTP_QUERY_CONTENT_DISPOSITION 47
|
|
|
|
//
|
|
// HTTP 1.1 defined headers
|
|
//
|
|
|
|
#define HTTP_QUERY_AGE 48
|
|
#define HTTP_QUERY_CACHE_CONTROL 49
|
|
#define HTTP_QUERY_CONTENT_BASE 50
|
|
#define HTTP_QUERY_CONTENT_LOCATION 51
|
|
#define HTTP_QUERY_CONTENT_MD5 52
|
|
#define HTTP_QUERY_CONTENT_RANGE 53
|
|
#define HTTP_QUERY_ETAG 54
|
|
#define HTTP_QUERY_HOST 55
|
|
#define HTTP_QUERY_IF_MATCH 56
|
|
#define HTTP_QUERY_IF_NONE_MATCH 57
|
|
#define HTTP_QUERY_IF_RANGE 58
|
|
#define HTTP_QUERY_IF_UNMODIFIED_SINCE 59
|
|
#define HTTP_QUERY_MAX_FORWARDS 60
|
|
#define HTTP_QUERY_PROXY_AUTHORIZATION 61
|
|
#define HTTP_QUERY_RANGE 62
|
|
#define HTTP_QUERY_TRANSFER_ENCODING 63
|
|
#define HTTP_QUERY_UPGRADE 64
|
|
#define HTTP_QUERY_VARY 65
|
|
#define HTTP_QUERY_VIA 66
|
|
#define HTTP_QUERY_WARNING 67
|
|
|
|
#define HTTP_QUERY_MAX 67
|
|
|
|
//
|
|
// HTTP_QUERY_CUSTOM - if this special value is supplied as the dwInfoLevel
|
|
// parameter of HttpQueryInfo() then the lpBuffer parameter contains the name
|
|
// of the header we are to query
|
|
//
|
|
|
|
#define HTTP_QUERY_CUSTOM 65535
|
|
|
|
//
|
|
// HTTP_QUERY_FLAG_REQUEST_HEADERS - if this bit is set in the dwInfoLevel
|
|
// parameter of HttpQueryInfo() then the request headers will be queried for the
|
|
// request information
|
|
//
|
|
|
|
#define HTTP_QUERY_FLAG_REQUEST_HEADERS 0x80000000
|
|
|
|
//
|
|
// HTTP_QUERY_FLAG_SYSTEMTIME - if this bit is set in the dwInfoLevel parameter
|
|
// of HttpQueryInfo() AND the header being queried contains date information,
|
|
// e.g. the "Expires:" header then lpBuffer will contain a SYSTEMTIME structure
|
|
// containing the date and time information converted from the header string
|
|
//
|
|
|
|
#define HTTP_QUERY_FLAG_SYSTEMTIME 0x40000000
|
|
|
|
//
|
|
// HTTP_QUERY_FLAG_NUMBER - if this bit is set in the dwInfoLevel parameter of
|
|
// HttpQueryInfo(), then the value of the header will be converted to a number
|
|
// before being returned to the caller, if applicable
|
|
//
|
|
|
|
#define HTTP_QUERY_FLAG_NUMBER 0x20000000
|
|
|
|
//
|
|
// HTTP_QUERY_FLAG_COALESCE - combine the values from several headers of the
|
|
// same name into the output buffer
|
|
//
|
|
|
|
#define HTTP_QUERY_FLAG_COALESCE 0x10000000
|
|
|
|
|
|
#define HTTP_QUERY_MODIFIER_FLAGS_MASK (HTTP_QUERY_FLAG_REQUEST_HEADERS \
|
|
| HTTP_QUERY_FLAG_SYSTEMTIME \
|
|
| HTTP_QUERY_FLAG_NUMBER \
|
|
| HTTP_QUERY_FLAG_COALESCE \
|
|
)
|
|
|
|
#define HTTP_QUERY_HEADER_MASK (~HTTP_QUERY_MODIFIER_FLAGS_MASK)
|
|
|
|
//
|
|
// HTTP Response Status Codes:
|
|
//
|
|
|
|
#define HTTP_STATUS_CONTINUE 100 // OK to continue with request
|
|
#define HTTP_STATUS_SWITCH_PROTOCOLS 101 // server has switched protocols in upgrade header
|
|
|
|
#define HTTP_STATUS_OK 200 // request completed
|
|
#define HTTP_STATUS_CREATED 201 // object created, reason = new URI
|
|
#define HTTP_STATUS_ACCEPTED 202 // async completion (TBS)
|
|
#define HTTP_STATUS_PARTIAL 203 // partial completion
|
|
#define HTTP_STATUS_NO_CONTENT 204 // no info to return
|
|
#define HTTP_STATUS_RESET_CONTENT 205 // request completed, but clear form
|
|
#define HTTP_STATUS_PARTIAL_CONTENT 206 // partial GET furfilled
|
|
|
|
#define HTTP_STATUS_AMBIGUOUS 300 // server couldn't decide what to return
|
|
#define HTTP_STATUS_MOVED 301 // object permanently moved
|
|
#define HTTP_STATUS_REDIRECT 302 // object temporarily moved
|
|
#define HTTP_STATUS_REDIRECT_METHOD 303 // redirection w/ new access method
|
|
#define HTTP_STATUS_NOT_MODIFIED 304 // if-modified-since was not modified
|
|
#define HTTP_STATUS_USE_PROXY 305 // redirection to proxy, location header specifies proxy to use
|
|
#define HTTP_STATUS_REDIRECT_KEEP_VERB 307 // HTTP/1.1: keep same verb
|
|
|
|
#define HTTP_STATUS_BAD_REQUEST 400 // invalid syntax
|
|
#define HTTP_STATUS_DENIED 401 // access denied
|
|
#define HTTP_STATUS_PAYMENT_REQ 402 // payment required
|
|
#define HTTP_STATUS_FORBIDDEN 403 // request forbidden
|
|
#define HTTP_STATUS_NOT_FOUND 404 // object not found
|
|
#define HTTP_STATUS_BAD_METHOD 405 // method is not allowed
|
|
#define HTTP_STATUS_NONE_ACCEPTABLE 406 // no response acceptable to client found
|
|
#define HTTP_STATUS_PROXY_AUTH_REQ 407 // proxy authentication required
|
|
#define HTTP_STATUS_REQUEST_TIMEOUT 408 // server timed out waiting for request
|
|
#define HTTP_STATUS_CONFLICT 409 // user should resubmit with more info
|
|
#define HTTP_STATUS_GONE 410 // the resource is no longer available
|
|
#define HTTP_STATUS_LENGTH_REQUIRED 411 // the server refused to accept request w/o a length
|
|
#define HTTP_STATUS_PRECOND_FAILED 412 // precondition given in request failed
|
|
#define HTTP_STATUS_REQUEST_TOO_LARGE 413 // request entity was too large
|
|
#define HTTP_STATUS_URI_TOO_LONG 414 // request URI too long
|
|
#define HTTP_STATUS_UNSUPPORTED_MEDIA 415 // unsupported media type
|
|
|
|
#define HTTP_STATUS_SERVER_ERROR 500 // internal server error
|
|
#define HTTP_STATUS_NOT_SUPPORTED 501 // required not supported
|
|
#define HTTP_STATUS_BAD_GATEWAY 502 // error response received from gateway
|
|
#define HTTP_STATUS_SERVICE_UNAVAIL 503 // temporarily overloaded
|
|
#define HTTP_STATUS_GATEWAY_TIMEOUT 504 // timed out waiting for gateway
|
|
#define HTTP_STATUS_VERSION_NOT_SUP 505 // HTTP version not supported
|
|
|
|
#define HTTP_STATUS_FIRST HTTP_STATUS_CONTINUE
|
|
#define HTTP_STATUS_LAST HTTP_STATUS_VERSION_NOT_SUP
|
|
|
|
//
|
|
// prototypes
|
|
//
|
|
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
HttpOpenRequestA(
|
|
IN HINTERNET hConnect,
|
|
IN LPCSTR lpszVerb,
|
|
IN LPCSTR lpszObjectName,
|
|
IN LPCSTR lpszVersion,
|
|
IN LPCSTR lpszReferrer OPTIONAL,
|
|
IN LPCSTR FAR * lplpszAcceptTypes OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
HINTERNET
|
|
WINAPI
|
|
HttpOpenRequestW(
|
|
IN HINTERNET hConnect,
|
|
IN LPCWSTR lpszVerb,
|
|
IN LPCWSTR lpszObjectName,
|
|
IN LPCWSTR lpszVersion,
|
|
IN LPCWSTR lpszReferrer OPTIONAL,
|
|
IN LPCWSTR FAR * lplpszAcceptTypes OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define HttpOpenRequest HttpOpenRequestW
|
|
#else
|
|
#define HttpOpenRequest HttpOpenRequestA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
HttpAddRequestHeadersA(
|
|
IN HINTERNET hRequest,
|
|
IN LPCSTR lpszHeaders,
|
|
IN DWORD dwHeadersLength,
|
|
IN DWORD dwModifiers
|
|
);
|
|
BOOLAPI
|
|
HttpAddRequestHeadersW(
|
|
IN HINTERNET hRequest,
|
|
IN LPCWSTR lpszHeaders,
|
|
IN DWORD dwHeadersLength,
|
|
IN DWORD dwModifiers
|
|
);
|
|
#ifdef UNICODE
|
|
#define HttpAddRequestHeaders HttpAddRequestHeadersW
|
|
#else
|
|
#define HttpAddRequestHeaders HttpAddRequestHeadersA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// values for dwModifiers parameter of HttpAddRequestHeaders()
|
|
//
|
|
|
|
#define HTTP_ADDREQ_INDEX_MASK 0x0000FFFF
|
|
#define HTTP_ADDREQ_FLAGS_MASK 0xFFFF0000
|
|
|
|
//
|
|
// HTTP_ADDREQ_FLAG_ADD_IF_NEW - the header will only be added if it doesn't
|
|
// already exist
|
|
//
|
|
|
|
#define HTTP_ADDREQ_FLAG_ADD_IF_NEW 0x10000000
|
|
|
|
//
|
|
// HTTP_ADDREQ_FLAG_ADD - if HTTP_ADDREQ_FLAG_REPLACE is set but the header is
|
|
// not found then if this flag is set, the header is added anyway, so long as
|
|
// there is a valid header-value
|
|
//
|
|
|
|
#define HTTP_ADDREQ_FLAG_ADD 0x20000000
|
|
|
|
//
|
|
// HTTP_ADDREQ_FLAG_COALESCE - coalesce headers with same name. e.g.
|
|
// "Accept: text/*" and "Accept: audio/*" with this flag results in a single
|
|
// header: "Accept: text/*, audio/*"
|
|
//
|
|
|
|
#define HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA 0x40000000
|
|
#define HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON 0x01000000
|
|
#define HTTP_ADDREQ_FLAG_COALESCE HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
|
|
|
|
//
|
|
// HTTP_ADDREQ_FLAG_REPLACE - replaces the specified header. Only one header can
|
|
// be supplied in the buffer. If the header to be replaced is not the first
|
|
// in a list of headers with the same name, then the relative index should be
|
|
// supplied in the low 8 bits of the dwModifiers parameter. If the header-value
|
|
// part is missing, then the header is removed
|
|
//
|
|
|
|
#define HTTP_ADDREQ_FLAG_REPLACE 0x80000000
|
|
|
|
BOOLAPI
|
|
HttpSendRequestA(
|
|
IN HINTERNET hRequest,
|
|
IN LPCSTR lpszHeaders OPTIONAL,
|
|
IN DWORD dwHeadersLength,
|
|
IN LPVOID lpOptional OPTIONAL,
|
|
IN DWORD dwOptionalLength
|
|
);
|
|
BOOLAPI
|
|
HttpSendRequestW(
|
|
IN HINTERNET hRequest,
|
|
IN LPCWSTR lpszHeaders OPTIONAL,
|
|
IN DWORD dwHeadersLength,
|
|
IN LPVOID lpOptional OPTIONAL,
|
|
IN DWORD dwOptionalLength
|
|
);
|
|
#ifdef UNICODE
|
|
#define HttpSendRequest HttpSendRequestW
|
|
#else
|
|
#define HttpSendRequest HttpSendRequestA
|
|
#endif // !UNICODE
|
|
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
HttpSendRequestExA(
|
|
IN HINTERNET hRequest,
|
|
IN LPINTERNET_BUFFERSA lpBuffersIn OPTIONAL,
|
|
OUT LPINTERNET_BUFFERSA lpBuffersOut OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
HttpSendRequestExW(
|
|
IN HINTERNET hRequest,
|
|
IN LPINTERNET_BUFFERSW lpBuffersIn OPTIONAL,
|
|
OUT LPINTERNET_BUFFERSW lpBuffersOut OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define HttpSendRequestEx HttpSendRequestExW
|
|
#else
|
|
#define HttpSendRequestEx HttpSendRequestExA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// flags for HttpSendRequestEx(), HttpEndRequest()
|
|
//
|
|
|
|
#define HSR_ASYNC WININET_API_FLAG_ASYNC // force async
|
|
#define HSR_SYNC WININET_API_FLAG_SYNC // force sync
|
|
#define HSR_USE_CONTEXT WININET_API_FLAG_USE_CONTEXT // use dwContext value
|
|
#define HSR_INITIATE 0x00000008 // iterative operation (completed by HttpEndRequest)
|
|
#define HSR_DOWNLOAD 0x00000010 // download to file
|
|
#define HSR_CHUNKED 0x00000020 // operation is send of chunked data
|
|
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
HttpEndRequestA(
|
|
IN HINTERNET hRequest,
|
|
OUT LPINTERNET_BUFFERSA lpBuffersOut OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
HttpEndRequestW(
|
|
IN HINTERNET hRequest,
|
|
OUT LPINTERNET_BUFFERSW lpBuffersOut OPTIONAL,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwContext
|
|
);
|
|
#ifdef UNICODE
|
|
#define HttpEndRequest HttpEndRequestW
|
|
#else
|
|
#define HttpEndRequest HttpEndRequestA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
HttpQueryInfoA(
|
|
IN HINTERNET hRequest,
|
|
IN DWORD dwInfoLevel,
|
|
IN OUT LPVOID lpBuffer OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength,
|
|
IN OUT LPDWORD lpdwIndex OPTIONAL
|
|
);
|
|
BOOLAPI
|
|
HttpQueryInfoW(
|
|
IN HINTERNET hRequest,
|
|
IN DWORD dwInfoLevel,
|
|
IN OUT LPVOID lpBuffer OPTIONAL,
|
|
IN OUT LPDWORD lpdwBufferLength,
|
|
IN OUT LPDWORD lpdwIndex OPTIONAL
|
|
);
|
|
#ifdef UNICODE
|
|
#define HttpQueryInfo HttpQueryInfoW
|
|
#else
|
|
#define HttpQueryInfo HttpQueryInfoA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// Cookie APIs
|
|
//
|
|
|
|
|
|
BOOLAPI
|
|
InternetSetCookieA(
|
|
IN LPCSTR lpszUrl,
|
|
IN LPCSTR lpszCookieName,
|
|
IN LPCSTR lpszCookieData
|
|
);
|
|
BOOLAPI
|
|
InternetSetCookieW(
|
|
IN LPCSTR lpszUrl,
|
|
IN LPCWSTR lpszCookieName,
|
|
IN LPCWSTR lpszCookieData
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetSetCookie InternetSetCookieW
|
|
#else
|
|
#define InternetSetCookie InternetSetCookieA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
InternetGetCookieA(
|
|
IN LPCSTR lpszUrl,
|
|
IN LPCSTR lpszCookieName,
|
|
OUT LPSTR lpCookieData,
|
|
IN OUT LPDWORD lpdwSize
|
|
);
|
|
BOOLAPI
|
|
InternetGetCookieW(
|
|
IN LPCSTR lpszUrl,
|
|
IN LPCWSTR lpszCookieName,
|
|
OUT LPWSTR lpCookieData,
|
|
IN OUT LPDWORD lpdwSize
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetGetCookie InternetGetCookieW
|
|
#else
|
|
#define InternetGetCookie InternetGetCookieA
|
|
#endif // !UNICODE
|
|
|
|
|
|
//
|
|
// offline browsing
|
|
//
|
|
|
|
INTERNETAPI
|
|
DWORD
|
|
WINAPI
|
|
InternetAttemptConnect(
|
|
IN DWORD dwReserved
|
|
);
|
|
|
|
BOOLAPI
|
|
InternetCheckConnectionA(
|
|
IN LPCSTR lpszUrl,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwReserved
|
|
);
|
|
BOOLAPI
|
|
InternetCheckConnectionW(
|
|
IN LPCWSTR lpszUrl,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwReserved
|
|
);
|
|
#ifdef UNICODE
|
|
#define InternetCheckConnection InternetCheckConnectionW
|
|
#else
|
|
#define InternetCheckConnection InternetCheckConnectionA
|
|
#endif // !UNICODE
|
|
|
|
#define FLAG_ICC_FORCE_CONNECTION 0x00000001
|
|
|
|
//
|
|
// Internet UI
|
|
//
|
|
|
|
//
|
|
// InternetErrorDlg - Provides UI for certain Errors.
|
|
//
|
|
|
|
#define FLAGS_ERROR_UI_FILTER_FOR_ERRORS 0x01
|
|
#define FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS 0x02
|
|
#define FLAGS_ERROR_UI_FLAGS_GENERATE_DATA 0x04
|
|
#define FLAGS_ERROR_UI_FLAGS_NO_UI 0x08
|
|
#define FLAGS_ERROR_UI_SERIALIZE_DIALOGS 0x10
|
|
|
|
//
|
|
// If SERIALIZE_DIALOGS flag set, client should implement thread-safe non-blocking callback...
|
|
//
|
|
|
|
DWORD InternetAuthNotifyCallback
|
|
(
|
|
DWORD dwContext, // as passed to InternetErrorDlg
|
|
DWORD dwReturn, // error code: success, resend, or cancel
|
|
LPVOID lpReserved // reserved: will be set to null
|
|
);
|
|
typedef DWORD (CALLBACK * PFN_AUTH_NOTIFY) (DWORD, DWORD, LPVOID);
|
|
|
|
//
|
|
// ... and last parameter of InternetErrorDlg should point to...
|
|
//
|
|
|
|
typedef struct
|
|
{
|
|
DWORD cbStruct; // size of this structure
|
|
DWORD dwOptions; // reserved: must set to 0
|
|
PFN_AUTH_NOTIFY pfnNotify; // notification callback to retry InternetErrorDlg
|
|
DWORD dwContext; // context to pass to to notification function
|
|
}
|
|
INTERNET_AUTH_NOTIFY_DATA;
|
|
|
|
|
|
INTERNETAPI
|
|
DWORD
|
|
WINAPI
|
|
InternetErrorDlg(
|
|
IN HWND hWnd,
|
|
IN OUT HINTERNET hRequest,
|
|
IN DWORD dwError,
|
|
IN DWORD dwFlags,
|
|
IN OUT LPVOID * lppvData
|
|
);
|
|
|
|
INTERNETAPI
|
|
DWORD
|
|
WINAPI
|
|
InternetConfirmZoneCrossing(
|
|
IN HWND hWnd,
|
|
IN LPSTR szUrlPrev,
|
|
IN LPSTR szUrlNew,
|
|
IN BOOL bPost
|
|
);
|
|
|
|
|
|
//#if !defined(_WINERROR_)
|
|
|
|
//
|
|
// Internet API error returns
|
|
//
|
|
|
|
#define INTERNET_ERROR_BASE 12000
|
|
|
|
#define ERROR_INTERNET_OUT_OF_HANDLES (INTERNET_ERROR_BASE + 1)
|
|
#define ERROR_INTERNET_TIMEOUT (INTERNET_ERROR_BASE + 2)
|
|
#define ERROR_INTERNET_EXTENDED_ERROR (INTERNET_ERROR_BASE + 3)
|
|
#define ERROR_INTERNET_INTERNAL_ERROR (INTERNET_ERROR_BASE + 4)
|
|
#define ERROR_INTERNET_INVALID_URL (INTERNET_ERROR_BASE + 5)
|
|
#define ERROR_INTERNET_UNRECOGNIZED_SCHEME (INTERNET_ERROR_BASE + 6)
|
|
#define ERROR_INTERNET_NAME_NOT_RESOLVED (INTERNET_ERROR_BASE + 7)
|
|
#define ERROR_INTERNET_PROTOCOL_NOT_FOUND (INTERNET_ERROR_BASE + 8)
|
|
#define ERROR_INTERNET_INVALID_OPTION (INTERNET_ERROR_BASE + 9)
|
|
#define ERROR_INTERNET_BAD_OPTION_LENGTH (INTERNET_ERROR_BASE + 10)
|
|
#define ERROR_INTERNET_OPTION_NOT_SETTABLE (INTERNET_ERROR_BASE + 11)
|
|
#define ERROR_INTERNET_SHUTDOWN (INTERNET_ERROR_BASE + 12)
|
|
#define ERROR_INTERNET_INCORRECT_USER_NAME (INTERNET_ERROR_BASE + 13)
|
|
#define ERROR_INTERNET_INCORRECT_PASSWORD (INTERNET_ERROR_BASE + 14)
|
|
#define ERROR_INTERNET_LOGIN_FAILURE (INTERNET_ERROR_BASE + 15)
|
|
#define ERROR_INTERNET_INVALID_OPERATION (INTERNET_ERROR_BASE + 16)
|
|
#define ERROR_INTERNET_OPERATION_CANCELLED (INTERNET_ERROR_BASE + 17)
|
|
#define ERROR_INTERNET_INCORRECT_HANDLE_TYPE (INTERNET_ERROR_BASE + 18)
|
|
#define ERROR_INTERNET_INCORRECT_HANDLE_STATE (INTERNET_ERROR_BASE + 19)
|
|
#define ERROR_INTERNET_NOT_PROXY_REQUEST (INTERNET_ERROR_BASE + 20)
|
|
#define ERROR_INTERNET_REGISTRY_VALUE_NOT_FOUND (INTERNET_ERROR_BASE + 21)
|
|
#define ERROR_INTERNET_BAD_REGISTRY_PARAMETER (INTERNET_ERROR_BASE + 22)
|
|
#define ERROR_INTERNET_NO_DIRECT_ACCESS (INTERNET_ERROR_BASE + 23)
|
|
#define ERROR_INTERNET_NO_CONTEXT (INTERNET_ERROR_BASE + 24)
|
|
#define ERROR_INTERNET_NO_CALLBACK (INTERNET_ERROR_BASE + 25)
|
|
#define ERROR_INTERNET_REQUEST_PENDING (INTERNET_ERROR_BASE + 26)
|
|
#define ERROR_INTERNET_INCORRECT_FORMAT (INTERNET_ERROR_BASE + 27)
|
|
#define ERROR_INTERNET_ITEM_NOT_FOUND (INTERNET_ERROR_BASE + 28)
|
|
#define ERROR_INTERNET_CANNOT_CONNECT (INTERNET_ERROR_BASE + 29)
|
|
#define ERROR_INTERNET_CONNECTION_ABORTED (INTERNET_ERROR_BASE + 30)
|
|
#define ERROR_INTERNET_CONNECTION_RESET (INTERNET_ERROR_BASE + 31)
|
|
#define ERROR_INTERNET_FORCE_RETRY (INTERNET_ERROR_BASE + 32)
|
|
#define ERROR_INTERNET_INVALID_PROXY_REQUEST (INTERNET_ERROR_BASE + 33)
|
|
#define ERROR_INTERNET_NEED_UI (INTERNET_ERROR_BASE + 34)
|
|
|
|
#define ERROR_INTERNET_HANDLE_EXISTS (INTERNET_ERROR_BASE + 36)
|
|
#define ERROR_INTERNET_SEC_CERT_DATE_INVALID (INTERNET_ERROR_BASE + 37)
|
|
#define ERROR_INTERNET_SEC_CERT_CN_INVALID (INTERNET_ERROR_BASE + 38)
|
|
#define ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR (INTERNET_ERROR_BASE + 39)
|
|
#define ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR (INTERNET_ERROR_BASE + 40)
|
|
#define ERROR_INTERNET_MIXED_SECURITY (INTERNET_ERROR_BASE + 41)
|
|
#define ERROR_INTERNET_CHG_POST_IS_NON_SECURE (INTERNET_ERROR_BASE + 42)
|
|
#define ERROR_INTERNET_POST_IS_NON_SECURE (INTERNET_ERROR_BASE + 43)
|
|
#define ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED (INTERNET_ERROR_BASE + 44)
|
|
#define ERROR_INTERNET_INVALID_CA (INTERNET_ERROR_BASE + 45)
|
|
#define ERROR_INTERNET_CLIENT_AUTH_NOT_SETUP (INTERNET_ERROR_BASE + 46)
|
|
#define ERROR_INTERNET_ASYNC_THREAD_FAILED (INTERNET_ERROR_BASE + 47)
|
|
#define ERROR_INTERNET_REDIRECT_SCHEME_CHANGE (INTERNET_ERROR_BASE + 48)
|
|
#define ERROR_INTERNET_DIALOG_PENDING (INTERNET_ERROR_BASE + 49)
|
|
#define ERROR_INTERNET_RETRY_DIALOG (INTERNET_ERROR_BASE + 50)
|
|
#define ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR (INTERNET_ERROR_BASE + 52)
|
|
#define ERROR_INTERNET_INSERT_CDROM (INTERNET_ERROR_BASE + 53)
|
|
|
|
|
|
//
|
|
// FTP API errors
|
|
//
|
|
|
|
#define ERROR_FTP_TRANSFER_IN_PROGRESS (INTERNET_ERROR_BASE + 110)
|
|
#define ERROR_FTP_DROPPED (INTERNET_ERROR_BASE + 111)
|
|
#define ERROR_FTP_NO_PASSIVE_MODE (INTERNET_ERROR_BASE + 112)
|
|
|
|
//
|
|
// gopher API errors
|
|
//
|
|
|
|
#define ERROR_GOPHER_PROTOCOL_ERROR (INTERNET_ERROR_BASE + 130)
|
|
#define ERROR_GOPHER_NOT_FILE (INTERNET_ERROR_BASE + 131)
|
|
#define ERROR_GOPHER_DATA_ERROR (INTERNET_ERROR_BASE + 132)
|
|
#define ERROR_GOPHER_END_OF_DATA (INTERNET_ERROR_BASE + 133)
|
|
#define ERROR_GOPHER_INVALID_LOCATOR (INTERNET_ERROR_BASE + 134)
|
|
#define ERROR_GOPHER_INCORRECT_LOCATOR_TYPE (INTERNET_ERROR_BASE + 135)
|
|
#define ERROR_GOPHER_NOT_GOPHER_PLUS (INTERNET_ERROR_BASE + 136)
|
|
#define ERROR_GOPHER_ATTRIBUTE_NOT_FOUND (INTERNET_ERROR_BASE + 137)
|
|
#define ERROR_GOPHER_UNKNOWN_LOCATOR (INTERNET_ERROR_BASE + 138)
|
|
|
|
//
|
|
// HTTP API errors
|
|
//
|
|
|
|
#define ERROR_HTTP_HEADER_NOT_FOUND (INTERNET_ERROR_BASE + 150)
|
|
#define ERROR_HTTP_DOWNLEVEL_SERVER (INTERNET_ERROR_BASE + 151)
|
|
#define ERROR_HTTP_INVALID_SERVER_RESPONSE (INTERNET_ERROR_BASE + 152)
|
|
#define ERROR_HTTP_INVALID_HEADER (INTERNET_ERROR_BASE + 153)
|
|
#define ERROR_HTTP_INVALID_QUERY_REQUEST (INTERNET_ERROR_BASE + 154)
|
|
#define ERROR_HTTP_HEADER_ALREADY_EXISTS (INTERNET_ERROR_BASE + 155)
|
|
#define ERROR_HTTP_REDIRECT_FAILED (INTERNET_ERROR_BASE + 156)
|
|
#define ERROR_HTTP_NOT_REDIRECTED (INTERNET_ERROR_BASE + 160)
|
|
#define ERROR_HTTP_COOKIE_NEEDS_CONFIRMATION (INTERNET_ERROR_BASE + 161)
|
|
#define ERROR_HTTP_COOKIE_DECLINED (INTERNET_ERROR_BASE + 162)
|
|
#define ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION (INTERNET_ERROR_BASE + 168)
|
|
|
|
//
|
|
// additional Internet API error codes
|
|
//
|
|
|
|
#define ERROR_INTERNET_SECURITY_CHANNEL_ERROR (INTERNET_ERROR_BASE + 157)
|
|
#define ERROR_INTERNET_UNABLE_TO_CACHE_FILE (INTERNET_ERROR_BASE + 158)
|
|
#define ERROR_INTERNET_TCPIP_NOT_INSTALLED (INTERNET_ERROR_BASE + 159)
|
|
#define ERROR_INTERNET_DISCONNECTED (INTERNET_ERROR_BASE + 163)
|
|
#define ERROR_INTERNET_SERVER_UNREACHABLE (INTERNET_ERROR_BASE + 164)
|
|
#define ERROR_INTERNET_PROXY_SERVER_UNREACHABLE (INTERNET_ERROR_BASE + 165)
|
|
|
|
#define ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT (INTERNET_ERROR_BASE + 166)
|
|
#define ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT (INTERNET_ERROR_BASE + 167)
|
|
#define ERROR_INTERNET_SEC_INVALID_CERT (INTERNET_ERROR_BASE + 169)
|
|
#define ERROR_INTERNET_SEC_CERT_REVOKED (INTERNET_ERROR_BASE + 170)
|
|
|
|
// InternetAutodial specific errors
|
|
|
|
#define ERROR_INTERNET_FAILED_DUETOSECURITYCHECK (INTERNET_ERROR_BASE + 171)
|
|
|
|
#define INTERNET_ERROR_LAST ERROR_INTERNET_FAILED_DUETOSECURITYCHECK
|
|
|
|
|
|
//#endif // !defined(_WINERROR_)
|
|
|
|
//
|
|
// URLCACHE APIs
|
|
//
|
|
|
|
//
|
|
// datatype definitions.
|
|
//
|
|
|
|
//
|
|
// cache entry type flags.
|
|
//
|
|
|
|
#define NORMAL_CACHE_ENTRY 0x00000001
|
|
#define COOKIE_CACHE_ENTRY 0x00100000
|
|
#define URLHISTORY_CACHE_ENTRY 0x00200000
|
|
#define TRACK_OFFLINE_CACHE_ENTRY 0x00000010
|
|
#define TRACK_ONLINE_CACHE_ENTRY 0x00000020
|
|
#define STICKY_CACHE_ENTRY 0x00000004
|
|
#define SPARSE_CACHE_ENTRY 0x00010000
|
|
|
|
|
|
|
|
#define URLCACHE_FIND_DEFAULT_FILTER NORMAL_CACHE_ENTRY \
|
|
| COOKIE_CACHE_ENTRY \
|
|
| URLHISTORY_CACHE_ENTRY \
|
|
| TRACK_OFFLINE_CACHE_ENTRY \
|
|
| TRACK_ONLINE_CACHE_ENTRY \
|
|
| STICKY_CACHE_ENTRY
|
|
|
|
|
|
|
|
//
|
|
// INTERNET_CACHE_ENTRY_INFO -
|
|
//
|
|
|
|
|
|
typedef struct _INTERNET_CACHE_ENTRY_INFOA {
|
|
DWORD dwStructSize; // version of cache system.
|
|
LPSTR lpszSourceUrlName; // embedded pointer to the URL name string.
|
|
LPSTR lpszLocalFileName; // embedded pointer to the local file name.
|
|
DWORD CacheEntryType; // cache type bit mask.
|
|
DWORD dwUseCount; // current users count of the cache entry.
|
|
DWORD dwHitRate; // num of times the cache entry was retrieved.
|
|
DWORD dwSizeLow; // low DWORD of the file size.
|
|
DWORD dwSizeHigh; // high DWORD of the file size.
|
|
FILETIME LastModifiedTime; // last modified time of the file in GMT format.
|
|
FILETIME ExpireTime; // expire time of the file in GMT format
|
|
FILETIME LastAccessTime; // last accessed time in GMT format
|
|
FILETIME LastSyncTime; // last time the URL was synchronized
|
|
// with the source
|
|
LPBYTE lpHeaderInfo; // embedded pointer to the header info.
|
|
DWORD dwHeaderInfoSize; // size of the above header.
|
|
LPSTR lpszFileExtension; // File extension used to retrive the urldata as a file.
|
|
union { // Exemption delta from last access time.
|
|
DWORD dwReserved;
|
|
DWORD dwExemptDelta;
|
|
}; // Exemption delta from last access
|
|
} INTERNET_CACHE_ENTRY_INFOA, * LPINTERNET_CACHE_ENTRY_INFOA;
|
|
typedef struct _INTERNET_CACHE_ENTRY_INFOW {
|
|
DWORD dwStructSize; // version of cache system.
|
|
LPSTR lpszSourceUrlName; // embedded pointer to the URL name string.
|
|
LPWSTR lpszLocalFileName; // embedded pointer to the local file name.
|
|
DWORD CacheEntryType; // cache type bit mask.
|
|
DWORD dwUseCount; // current users count of the cache entry.
|
|
DWORD dwHitRate; // num of times the cache entry was retrieved.
|
|
DWORD dwSizeLow; // low DWORD of the file size.
|
|
DWORD dwSizeHigh; // high DWORD of the file size.
|
|
FILETIME LastModifiedTime; // last modified time of the file in GMT format.
|
|
FILETIME ExpireTime; // expire time of the file in GMT format
|
|
FILETIME LastAccessTime; // last accessed time in GMT format
|
|
FILETIME LastSyncTime; // last time the URL was synchronized
|
|
// with the source
|
|
LPBYTE lpHeaderInfo; // embedded pointer to the header info.
|
|
DWORD dwHeaderInfoSize; // size of the above header.
|
|
LPWSTR lpszFileExtension; // File extension used to retrive the urldata as a file.
|
|
union { // Exemption delta from last access time.
|
|
DWORD dwReserved;
|
|
DWORD dwExemptDelta;
|
|
}; // Exemption delta from last access
|
|
} INTERNET_CACHE_ENTRY_INFOW, * LPINTERNET_CACHE_ENTRY_INFOW;
|
|
#ifdef UNICODE
|
|
typedef INTERNET_CACHE_ENTRY_INFOW INTERNET_CACHE_ENTRY_INFO;
|
|
typedef LPINTERNET_CACHE_ENTRY_INFOW LPINTERNET_CACHE_ENTRY_INFO;
|
|
#else
|
|
typedef INTERNET_CACHE_ENTRY_INFOA INTERNET_CACHE_ENTRY_INFO;
|
|
typedef LPINTERNET_CACHE_ENTRY_INFOA LPINTERNET_CACHE_ENTRY_INFO;
|
|
#endif // UNICODE
|
|
|
|
|
|
//
|
|
// Cache APIs
|
|
//
|
|
|
|
BOOLAPI
|
|
CreateUrlCacheEntryA(
|
|
IN LPCSTR lpszUrlName,
|
|
IN DWORD dwExpectedFileSize,
|
|
IN LPCSTR lpszFileExtension,
|
|
OUT LPSTR lpszFileName,
|
|
IN DWORD dwReserved
|
|
);
|
|
BOOLAPI
|
|
CreateUrlCacheEntryW(
|
|
IN LPCSTR lpszUrlName,
|
|
IN DWORD dwExpectedFileSize,
|
|
IN LPCSTR lpszFileExtension,
|
|
OUT LPWSTR lpszFileName,
|
|
IN DWORD dwReserved
|
|
);
|
|
#ifdef UNICODE
|
|
#define CreateUrlCacheEntry CreateUrlCacheEntryW
|
|
#else
|
|
#define CreateUrlCacheEntry CreateUrlCacheEntryA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
CommitUrlCacheEntryA(
|
|
IN LPCSTR lpszUrlName,
|
|
IN LPCSTR lpszLocalFileName,
|
|
IN FILETIME ExpireTime,
|
|
IN FILETIME LastModifiedTime,
|
|
IN DWORD CacheEntryType,
|
|
IN LPBYTE lpHeaderInfo,
|
|
IN DWORD dwHeaderSize,
|
|
IN LPCSTR lpszFileExtension,
|
|
IN DWORD dwReserved
|
|
);
|
|
BOOLAPI
|
|
CommitUrlCacheEntryW(
|
|
IN LPCSTR lpszUrlName,
|
|
IN LPCWSTR lpszLocalFileName,
|
|
IN FILETIME ExpireTime,
|
|
IN FILETIME LastModifiedTime,
|
|
IN DWORD CacheEntryType,
|
|
IN LPBYTE lpHeaderInfo,
|
|
IN DWORD dwHeaderSize,
|
|
IN LPCWSTR lpszFileExtension,
|
|
IN DWORD dwReserved
|
|
);
|
|
#ifdef UNICODE
|
|
#define CommitUrlCacheEntry CommitUrlCacheEntryW
|
|
#else
|
|
#define CommitUrlCacheEntry CommitUrlCacheEntryA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
RetrieveUrlCacheEntryFileA(
|
|
IN LPCSTR lpszUrlName,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufferSize,
|
|
IN DWORD dwReserved
|
|
);
|
|
BOOLAPI
|
|
RetrieveUrlCacheEntryFileW(
|
|
IN LPCSTR lpszUrlName,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufferSize,
|
|
IN DWORD dwReserved
|
|
);
|
|
#ifdef UNICODE
|
|
#define RetrieveUrlCacheEntryFile RetrieveUrlCacheEntryFileW
|
|
#else
|
|
#define RetrieveUrlCacheEntryFile RetrieveUrlCacheEntryFileA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
UnlockUrlCacheEntryFile(
|
|
IN LPCSTR lpszUrlName,
|
|
IN DWORD dwReserved
|
|
);
|
|
|
|
INTERNETAPI
|
|
HANDLE
|
|
WINAPI
|
|
RetrieveUrlCacheEntryStreamA(
|
|
IN LPCSTR lpszUrlName,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufferSize,
|
|
IN BOOL fRandomRead,
|
|
IN DWORD dwReserved
|
|
);
|
|
INTERNETAPI
|
|
HANDLE
|
|
WINAPI
|
|
RetrieveUrlCacheEntryStreamW(
|
|
IN LPCSTR lpszUrlName,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufferSize,
|
|
IN BOOL fRandomRead,
|
|
IN DWORD dwReserved
|
|
);
|
|
#ifdef UNICODE
|
|
#define RetrieveUrlCacheEntryStream RetrieveUrlCacheEntryStreamW
|
|
#else
|
|
#define RetrieveUrlCacheEntryStream RetrieveUrlCacheEntryStreamA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
ReadUrlCacheEntryStream(
|
|
IN HANDLE hUrlCacheStream,
|
|
IN DWORD dwLocation,
|
|
IN OUT LPVOID lpBuffer,
|
|
IN OUT LPDWORD lpdwLen,
|
|
IN DWORD Reserved
|
|
);
|
|
|
|
BOOLAPI
|
|
UnlockUrlCacheEntryStream(
|
|
IN HANDLE hUrlCacheStream,
|
|
IN DWORD Reserved
|
|
);
|
|
|
|
|
|
BOOLAPI
|
|
GetUrlCacheEntryInfoA(
|
|
IN LPCSTR lpszUrlName,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufferSize
|
|
);
|
|
BOOLAPI
|
|
GetUrlCacheEntryInfoW(
|
|
IN LPCSTR lpszUrlName,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufferSize
|
|
);
|
|
#ifdef UNICODE
|
|
#define GetUrlCacheEntryInfo GetUrlCacheEntryInfoW
|
|
#else
|
|
#define GetUrlCacheEntryInfo GetUrlCacheEntryInfoA
|
|
#endif // !UNICODE
|
|
|
|
|
|
BOOLAPI
|
|
GetUrlCacheEntryInfoExA(
|
|
IN LPCSTR lpszUrl,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufSize,
|
|
OUT LPSTR lpszReserved, // must pass null
|
|
IN OUT LPDWORD lpdwReserved, // must pass null
|
|
LPVOID lpReserved, // must pass null
|
|
DWORD dwFlags // reserved
|
|
);
|
|
BOOLAPI
|
|
GetUrlCacheEntryInfoExW(
|
|
IN LPCSTR lpszUrl,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwCacheEntryInfoBufSize,
|
|
OUT LPSTR lpszReserved, // must pass null
|
|
IN OUT LPDWORD lpdwReserved, // must pass null
|
|
LPVOID lpReserved, // must pass null
|
|
DWORD dwFlags // reserved
|
|
);
|
|
#ifdef UNICODE
|
|
#define GetUrlCacheEntryInfoEx GetUrlCacheEntryInfoExW
|
|
#else
|
|
#define GetUrlCacheEntryInfoEx GetUrlCacheEntryInfoExA
|
|
#endif // !UNICODE
|
|
|
|
#define CACHE_ENTRY_ATTRIBUTE_FC 0x00000004
|
|
#define CACHE_ENTRY_HITRATE_FC 0x00000010
|
|
#define CACHE_ENTRY_MODTIME_FC 0x00000040
|
|
#define CACHE_ENTRY_EXPTIME_FC 0x00000080
|
|
#define CACHE_ENTRY_ACCTIME_FC 0x00000100
|
|
#define CACHE_ENTRY_SYNCTIME_FC 0x00000200
|
|
#define CACHE_ENTRY_HEADERINFO_FC 0x00000400
|
|
#define CACHE_ENTRY_EXEMPT_DELTA_FC 0x00000800
|
|
|
|
|
|
BOOLAPI
|
|
SetUrlCacheEntryInfoA(
|
|
IN LPCSTR lpszUrlName,
|
|
IN LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
|
|
IN DWORD dwFieldControl
|
|
);
|
|
BOOLAPI
|
|
SetUrlCacheEntryInfoW(
|
|
IN LPCSTR lpszUrlName,
|
|
IN LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
|
|
IN DWORD dwFieldControl
|
|
);
|
|
#ifdef UNICODE
|
|
#define SetUrlCacheEntryInfo SetUrlCacheEntryInfoW
|
|
#else
|
|
#define SetUrlCacheEntryInfo SetUrlCacheEntryInfoA
|
|
#endif // !UNICODE
|
|
|
|
//
|
|
// Cache Group Functions
|
|
//
|
|
|
|
typedef LONGLONG GROUPID;
|
|
|
|
INTERNETAPI
|
|
GROUPID
|
|
WINAPI
|
|
CreateUrlCacheGroup(
|
|
IN DWORD dwFlags,
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
|
|
BOOLAPI
|
|
DeleteUrlCacheGroup(
|
|
IN GROUPID GroupId,
|
|
IN DWORD dwFlags, // must pass 0
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
|
|
// Flags for SetUrlCacheEntryGroup
|
|
#define INTERNET_CACHE_GROUP_ADD 0
|
|
#define INTERNET_CACHE_GROUP_REMOVE 1
|
|
|
|
BOOLAPI
|
|
SetUrlCacheEntryGroup(
|
|
IN LPCSTR lpszUrlName,
|
|
IN DWORD dwFlags,
|
|
IN GROUPID GroupId,
|
|
IN LPBYTE pbGroupAttributes, // must pass NULL
|
|
IN DWORD cbGroupAttributes, // must pass 0
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
|
|
INTERNETAPI
|
|
HANDLE
|
|
WINAPI
|
|
FindFirstUrlCacheEntryExA(
|
|
IN LPCSTR lpszUrlSearchPattern,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwFilter,
|
|
IN GROUPID GroupId,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize,
|
|
OUT LPVOID lpGroupAttributes, // must pass NULL
|
|
IN OUT LPDWORD pcbGroupAttributes, // must pass NULL
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
INTERNETAPI
|
|
HANDLE
|
|
WINAPI
|
|
FindFirstUrlCacheEntryExW(
|
|
IN LPCSTR lpszUrlSearchPattern,
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwFilter,
|
|
IN GROUPID GroupId,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize,
|
|
OUT LPVOID lpGroupAttributes, // must pass NULL
|
|
IN OUT LPDWORD pcbGroupAttributes, // must pass NULL
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
#ifdef UNICODE
|
|
#define FindFirstUrlCacheEntryEx FindFirstUrlCacheEntryExW
|
|
#else
|
|
#define FindFirstUrlCacheEntryEx FindFirstUrlCacheEntryExA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FindNextUrlCacheEntryExA(
|
|
IN HANDLE hEnumHandle,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize,
|
|
OUT LPVOID lpGroupAttributes, // must pass NULL
|
|
IN OUT LPDWORD pcbGroupAttributes, // must pass NULL
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
BOOLAPI
|
|
FindNextUrlCacheEntryExW(
|
|
IN HANDLE hEnumHandle,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize,
|
|
OUT LPVOID lpGroupAttributes, // must pass NULL
|
|
IN OUT LPDWORD pcbGroupAttributes, // must pass NULL
|
|
IN LPVOID lpReserved // must pass NULL
|
|
);
|
|
#ifdef UNICODE
|
|
#define FindNextUrlCacheEntryEx FindNextUrlCacheEntryExW
|
|
#else
|
|
#define FindNextUrlCacheEntryEx FindNextUrlCacheEntryExA
|
|
#endif // !UNICODE
|
|
|
|
INTERNETAPI
|
|
HANDLE
|
|
WINAPI
|
|
FindFirstUrlCacheEntryA(
|
|
IN LPCSTR lpszUrlSearchPattern,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize
|
|
);
|
|
INTERNETAPI
|
|
HANDLE
|
|
WINAPI
|
|
FindFirstUrlCacheEntryW(
|
|
IN LPCSTR lpszUrlSearchPattern,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize
|
|
);
|
|
#ifdef UNICODE
|
|
#define FindFirstUrlCacheEntry FindFirstUrlCacheEntryW
|
|
#else
|
|
#define FindFirstUrlCacheEntry FindFirstUrlCacheEntryA
|
|
#endif // !UNICODE
|
|
|
|
BOOLAPI
|
|
FindNextUrlCacheEntryA(
|
|
IN HANDLE hEnumHandle,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOA lpNextCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwNextCacheEntryInfoBufferSize
|
|
);
|
|
BOOLAPI
|
|
FindNextUrlCacheEntryW(
|
|
IN HANDLE hEnumHandle,
|
|
OUT LPINTERNET_CACHE_ENTRY_INFOW lpNextCacheEntryInfo,
|
|
IN OUT LPDWORD lpdwNextCacheEntryInfoBufferSize
|
|
);
|
|
#ifdef UNICODE
|
|
#define FindNextUrlCacheEntry FindNextUrlCacheEntryW
|
|
#else
|
|
#define FindNextUrlCacheEntry FindNextUrlCacheEntryA
|
|
#endif // !UNICODE
|
|
|
|
|
|
BOOLAPI
|
|
FindCloseUrlCache(
|
|
IN HANDLE hEnumHandle
|
|
);
|
|
|
|
BOOLAPI
|
|
DeleteUrlCacheEntry(
|
|
IN LPCSTR lpszUrlName
|
|
);
|
|
|
|
|
|
|
|
//
|
|
// Autodial APIs
|
|
//
|
|
|
|
INTERNETAPI
|
|
DWORD
|
|
WINAPI
|
|
InternetDial(
|
|
IN HWND hwndParent,
|
|
IN LPTSTR lpszConnectoid,
|
|
IN DWORD dwFlags,
|
|
OUT LPDWORD lpdwConnection,
|
|
IN DWORD dwReserved);
|
|
|
|
// Flags for InternetDial - must not conflict with InternetAutodial flags
|
|
// as they are valid here also.
|
|
#define INTERNET_DIAL_UNATTENDED 0x8000
|
|
|
|
INTERNETAPI
|
|
DWORD
|
|
WINAPI
|
|
InternetHangUp(
|
|
IN DWORD dwConnection,
|
|
IN DWORD dwReserved);
|
|
|
|
#define INTERENT_GOONLINE_REFRESH 0x00000001
|
|
#define INTERENT_GOONLINE_MASK 0x00000001
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetGoOnline(
|
|
IN LPTSTR lpszURL,
|
|
IN HWND hwndParent,
|
|
IN DWORD dwFlags);
|
|
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetAutodial(
|
|
IN DWORD dwFlags,
|
|
IN DWORD dwReserved);
|
|
|
|
// Flags for InternetAutodial
|
|
#define INTERNET_AUTODIAL_FORCE_ONLINE 1
|
|
#define INTERNET_AUTODIAL_FORCE_UNATTENDED 2
|
|
#define INTERNET_AUTODIAL_FAILIFSECURITYCHECK 4
|
|
|
|
#define INTERNET_AUTODIAL_FLAGS_MASK (INTERNET_AUTODIAL_FORCE_ONLINE | INTERNET_AUTODIAL_FORCE_UNATTENDED | INTERNET_AUTODIAL_FAILIFSECURITYCHECK)
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetAutodialHangup(
|
|
IN DWORD dwReserved);
|
|
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetGetConnectedState(
|
|
OUT LPDWORD lpdwFlags,
|
|
IN DWORD dwReserved);
|
|
|
|
// Flags for InternetGetConnectedState
|
|
#define INTERNET_CONNECTION_MODEM 1
|
|
#define INTERNET_CONNECTION_LAN 2
|
|
#define INTERNET_CONNECTION_PROXY 4
|
|
#define INTERNET_CONNECTION_MODEM_BUSY 8
|
|
|
|
//
|
|
// Custom dial handler functions
|
|
//
|
|
|
|
// Custom dial handler prototype
|
|
typedef DWORD (CALLBACK * PFN_DIAL_HANDLER) (HWND, LPCSTR, DWORD, LPDWORD);
|
|
|
|
// Flags for custom dial handler
|
|
#define INTERNET_CUSTOMDIAL_CONNECT 0
|
|
#define INTERNET_CUSTOMDIAL_UNATTENDED 1
|
|
#define INTERNET_CUSTOMDIAL_DISCONNECT 2
|
|
|
|
// Custom dial handler supported functionality flags
|
|
#define INTERNET_CUSTOMDIAL_SAFE_FOR_UNATTENDED 1
|
|
#define INTERNET_CUSTOMDIAL_WILL_SUPPLY_STATE 2
|
|
#define INTERNET_CUSTOMDIAL_CAN_HANGUP 4
|
|
|
|
INTERNETAPI
|
|
BOOL
|
|
WINAPI
|
|
InternetSetDialState(
|
|
IN LPCTSTR lpszConnectoid,
|
|
IN DWORD dwState,
|
|
IN DWORD dwReserved);
|
|
|
|
// States for InternetSetDialState
|
|
#define INTERNET_DIALSTATE_DISCONNECTED 1
|
|
|
|
|
|
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
|
|
/*
|
|
* Return packing to whatever it was before we
|
|
* entered this file
|
|
*/
|
|
#pragma pack(pop, wininet)
|
|
|
|
|
|
#endif // !defined(_WININET_)
|
|
|