Edit

WS_DURATION_COMPARISON_CALLBACK callback function (webservices.h)

  • Article

Compares two durations.A duration represents a unit of time as an eight-dimensional space where the coordinates designate the year, month, day, hour, minute, second, millisecond, and CPU tick as represented by the WS_DURATION data structure.

Syntax

WS_DURATION_COMPARISON_CALLBACK WsDurationComparisonCallback;

HRESULT WsDurationComparisonCallback(
  [in]           const WS_DURATION *duration1,
  [in]           const WS_DURATION *duration2,
  [out]          int *result,
  [in, optional] WS_ERROR *error
)
{...}

Parameters

[in] duration1

A pointer to a WS_DURATION structure representing the first duration to compare.

[in] duration2

A pointer to a WS_DURATION structure representing the second duration.

[out] result

The relationship between the durations as one of the following values:

  • -1 if duration1 is less than duration2
  • 0 if duration1 is equal to duration2
  • 1 if duration1 is greater than duration2

[in, optional] error

A pointer to a WS_ERROR handle where additional error information should be stored if the function fails.

Return value

This callback function does not return a value.

Remarks

If the function cannot compare the specified durations, it should return WS_E_INVALID_FORMAT. (See Windows Web Services Return Values.)

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header webservices.h