NWSMTSGetTargetServiceAPIVersion

Returns the API version of the target service.

Syntax

  #include <smstsapi.h> 
   
  CCODE NWSMTSGetTargetServiceAPIVersion (
     UINT32    connection, 
     UINT32   *majorVersion, 
     UINT32   *minorVersion);

Parameters

connection

(IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServiceEx.

majorversion

(OUT) Specifies the major version of the TSA.

minorversion

(OUT) Specifies the minor version of the TSA.

Return Values

See Section 9.3, Target Service Return Values for more information.

The following table lists the return values associated with the function.

0x00000000

Successful

0xFFFDFFE7

NWSMTS_INVALID_CONNECTION_HANDL

0xFFFDFFB1

NWSMTS_INTERNAL_ERROR

0xFFFDFFB9

NWSMTS_UNSUPPORTED_FUNCTION

0xFFFEFFFF

NWSMDR_INVALID_CONNECTION

Remarks

This API provides an internally negotiated minimum supported version for the connection. The version returned is specific to the connection and is based on the API version supported by SMDR at the backup server and the SMDR and TSA at the target server.

Before this API is called, the engine must be connected to the TSA.

The API is supported by the following versions:

  • NetWare 6.5 Support Pack 1 and later

  • NetWare 6.0 Support Pack 4

  • NetWare 5.1 Support Pack 7 and later

NOTE:This symbol is not present in the SMS import file, as all versions of SMS do not export this symbol. To use this function, programmatically import the symbol and invoke it.

See Also

NWSMTSConnectToTargetService, NWSMTSConnectToTargetServiceEx