WinMSStartup()
This function allows an application to specify the version of management services API required and to retrieve the version of the API supported by the product. This function can be called by an application before issuing any further management services API calls to register itself.
Syntax
int WINAPI WinMSStartup(WORD wVersionRequired,
LPWMSDATA msdata);Parameters
- wVersionRequired
- Specifies the version of management services API support required. The high-order byte specifies the minor version (revision) number; the low-order byte specifies the major version number.
- msdata
- Returns the version of management services API and a description of management services implementation.
Returns
The return value specifies whether the application was registered successfully
and whether the management services API implementation can support the specified
version number. If the value is zero, it was registered successfully and
the specified version can be supported. Otherwise, the return value is one
of the following values:
- WMSSYSERROR
- The underlying network subsystem is not ready for network communication.
- WMSVERNOTSUPPORTED
- The version of management services API support requested is not provided by this particular management services API implementation.
- WMSBADPOINTER
- Incorrect msdata parameter.
Remarks
WinMSStartup is intended to help with compatibility with future versions of the API. The current version supported is 1.0.
It is not a requirement to use WinMSStartup and WinMSCleanup. However, an application must be consistent
in its use of these calls. You should use both of them or never use either
of them.
Note: See also WinMSCleanup().