ITAddress2::NegotiateExtVersion method (tapi3if.h)

The NegotiateExtVersion method allows an application to negotiate an extension version to use with the specified line device. This method need not be called if the application does not support provider-specific extensions.

Syntax

HRESULT NegotiateExtVersion(
  [in]  long lLowVersion,
  [in]  long lHighVersion,
  [out] long *plExtVersion
);

Parameters

[in] lLowVersion

Least recent extension version of the extension identifier returned by NegotiateExtVersion that the application is compliant with. The high-order word is the major version number; the low-order word is the minor version number.

[in] lHighVersion

Most recent extension version of the extension identifier returned by NegotiateExtVersion that the application is compliant with. The high-order word is the major version number; the low-order word is the minor version number.

[out] plExtVersion

Pointer to a long that contains the extension version number that was negotiated. If negotiation succeeds, this number is in the range between lLowVersion and lHighVersion.

Return value

This method can return one of these values.

Value Meaning
S_OK
Method succeeded.
E_INVALIDARG
The version entered in either lLowVersion or lHighVersion is invalid.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
E_POINTER
The plExtVersion parameter is not a valid pointer.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

DeviceSpecific

DeviceSpecificVariant

lineNegotiateExtVersion