Função SnmpOidCompare (winsnmp.h)
[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]
A função WinSNMP SnmpOidCompare compara lexicograficamente dois identificadores de objeto SNMP, até o comprimento especificado pelo parâmetro maxlen .
Sintaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCompare(
[in] smiLPCOID xOID,
[in] smiLPCOID yOID,
[in] smiUINT32 maxlen,
[out] smiLPINT result
);
Parâmetros
[in] xOID
Ponteiro para o primeiro identificador de objeto smiOID a ser comparado. O comprimento do identificador de objeto pode ser zero.
[in] yOID
Ponteiro para o segundo identificador de objeto smiOID a ser comparado. O comprimento do identificador de objeto pode ser zero.
[in] maxlen
Se não for igual a zero, especifica o número de subidentificados a serem comparados. Esse parâmetro deve ser menor que MAXOBJIDSIZE: 128 subidentifiers, o número máximo de componentes em um identificador de objeto. Para obter informações adicionais, consulte a seção Comentários a seguir.
[out] result
Ponteiro para uma variável de inteiro para receber o resultado da comparação. A variável pode receber um dos resultados a seguir.
| Result | Significado |
|---|---|
|
xOID é maior que yOID |
|
xOID é igual a yOID |
|
xOID é menor que yOID |
Para obter condições de comparação adicionais, consulte a seção Comentários a seguir.
Retornar valor
Se a função for bem-sucedida, o valor retornado será SNMPAPI_SUCCESS.
Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.
| Código de retorno | Descrição |
|---|---|
|
A função SnmpStartup não foi concluída com êxito. |
|
Ocorreu um erro durante a alocação de memória. |
|
Um ou ambos os parâmetros xOID e yOID são inválidos. |
|
O parâmetro maxlen é inválido. O tamanho do parâmetro é maior que MAXOBJIDSIZE. |
|
Ocorreu um erro desconhecido ou indefinido. |
Comentários
Um aplicativo WinSNMP pode chamar a função SnmpOidCompare para determinar se dois identificadores de objeto têm prefixos comuns.
Se o parâmetro maxlen não for igual a zero e não for maior que MAXOBJIDSIZE, o valor de maxlen definirá o limite superior para o número de subidentifiers a serem comparados. O número máximo de subidentifiers que a função SnmpOidCompare compara o padrão com o menor número: o parâmetro maxlen ou o membro len de uma das estruturas smiOID apontadas pelos parâmetros xOID e yOID .
Se o parâmetro maxlen for igual a zero, o número máximo de subidentifiers que a função SnmpOidCompare comparará usará como padrão o número menor dos membros len das duas estruturas smiOID .
O valor do parâmetro de resultado indicará que xOID será igual a yOID se as duas estruturas smiOID forem lexicograficamente iguais e uma das seguintes ocorrer:
- SnmpOidCompare compara um número máximo de subidentifiers.
- SnmpOidCompare compara o número máximo de subidentifiers e os membros len de ambas as estruturas smiOID são iguais, mas menores que o parâmetro maxlen .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winsnmp.h |
| Biblioteca | Wsnmp32.lib |
| DLL | Wsnmp32.dll |