WinNOFStartup()
This function allows an application to specify the version of Node Operator Facility 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 Node Operator Facility API calls to register itself.
Syntax
int WINAPI WinNOFStartup(WORD wVersionRequired,
LPWNOFDATA nofdata);Parameters
- wVersionRequired
- Specifies the version of Node Operator Facility API support required. The high-order byte specifies the minor version (revision) number; the low-order byte specifies the major version number.
- nofdata
- Returns the version of Node Operator Facility API and a description of API implementation.
Returns
The return value specifies whether the application was registered successfully
and whether the Node Operator Facility 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:
- WNOFSYSERROR
- The underlying network subsystem is not ready for network communication.
- WNOFVERNOTSUPPORTED
- The version of Node Operator Facility API support requested is not provided by this particular implementation.
- WNOFBADPOINTER
- Incorrect nofdata parameter.
Remarks
This call is intended to help with compatibility of future releases of the API. The current version is 1.0.
It is not a requirement to use WinNOFStartup and WinNOFCleanup. However, an application must be consistent in its use of these calls. You should use both of them or never use either of them.