| BOOL
InetInitialize(
|
|
|
LPCTSTR
lpszLicenseKey, |
|
|
|
|
LPINITDATA
lpData |
|
|
| );
|
The InetInitialize function initializes the library and
validates the specified user license key at runtime. This must be
the first function that an application calls before using any of
the other functions in the library.
Parameters
- lpszLicenseKey
- Pointer to a null-terminated string that specifies the license
key to be validated. A value of NULL indicates that the licensing
information in the system registry should be validated.
- lpData
- Pointer to INITDATA data structure.
This parameter may be NULL if the initialization data for the
library is not required.
Return Value
If the function succeeds, the return value is non-zero. If the
function fails, the return value is zero. To get extended error
information, call InetGetLastError. All other functions will
fail until a license key has been successfully validated.
Remarks
When a NULL license key is specified, the library will only
function on the development system. Before redistributing the
application to an end-user, you must insure that this function is
called with a valid license key.
If the lpData argument is specified, it must point to an
INITDATA structure which has been initialized by setting the
dwSize member to the size of the structure. All other
structure members should be set to zero. If the function is
successful, then the INITDATA structure will be filled with
identifying information about the library.
Although it is only required that InetInitialize be
called once for the current process, it may be called multiple
times; however, each call must be matched by a corresponding call
to InetUninitialize.
Requirements
Client: Requires Windows Vista, Windows XP or Windows
2000 Professional.
Server: Requires Windows Server 2008, Windows Server 2003 or
Windows 2000 Server.
Header: Include cswsock6.h.
Library: Use cswskav6.lib.
Unicode: Implemented as Unicode and ANSI versions.
See Also
InetAsyncConnect, InetAsyncListen, InetConnect, InetDisconnect, InetListen, InetUninitialize
|