Função SnmpOidCopy (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 SnmpOidCopy copia um identificador de objeto SNMP, alocando qualquer memória necessária para a cópia.
Sintaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
[in] smiLPCOID srcOID,
[out] smiLPOID dstOID
);
Parâmetros
[in] srcOID
Ponteiro para uma estrutura smiOID a ser copiada.
[out] dstOID
Ponteiro para uma estrutura smiOID para receber uma cópia do identificador de objeto especificado pelo parâmetro srcOID .
Valor retornado
Se a função for bem-sucedida, o valor retornado será o número de subidentifiers no identificador de objeto copiado. Esse número também é o valor do membro len da estrutura smiOID apontada pelo parâmetro dstOID .
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. |
|
O parâmetro srcOID é inválido. |
|
Ocorreu um erro desconhecido ou indefinido. |
Comentários
Na entrada, a função SnmpOidCopy ignora os membros da estrutura smiOID apontada pelo parâmetro dstOID . A implementação do Microsoft WinSNMP substituirá os membros smiOID se a função for concluída com êxito.
O aplicativo WinSNMP deve chamar a função SnmpFreeDescriptor para habilitar a implementação para liberar recursos alocados para o membro ptr da estrutura smiOID apontada pelo parâmetro dstOID . Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados WinSNMP e Liberando descritores WinSNMP.
Requisitos
| 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 |