SnmpUtilOctetsNCmp function (snmp.h)

[SNMP is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Windows Remote Management, which is the Microsoft implementation of WS-Man.]

The SnmpUtilOctetsNCmp function compares two octet strings. The function compares the subidentifiers in the strings until it reaches the number of subidentifiers specified by the nChars parameter. SnmpUtilOctetsNCmp is an element of the SNMP Utility API.

Syntax

SNMPAPI SNMP_FUNC_TYPE SnmpUtilOctetsNCmp(
  [in] AsnOctetString *pOctets1,
  [in] AsnOctetString *pOctets2,
  [in] UINT           nChars
);

Parameters

[in] pOctets1

Pointer to an AsnOctetString structure to compare.

[in] pOctets2

Pointer to a second AsnOctetString structure to compare.

[in] nChars

Specifies the number of subidentifiers to compare.

Return value

The function returns a value greater than zero if pOctets1 is greater than pOctets2, zero if pOctets1 equals pOctets2, and less than zero if pOctets1 is less than pOctets2.

Remarks

The SnmpUtilOctetsCmp function calls the SnmpUtilOctetsNCmp function.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header snmp.h
Library Snmpapi.lib
DLL Snmpapi.dll

See also

AsnOctetString

SNMP Functions

Simple Network Management Protocol (SNMP) Overview

SnmpUtilOctetsCmp