SnmpUtilOctetsNCmp function (snmp.h)

Article
10/13/2021

[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