Função SnmpMgrRequest (mgmtapi.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 SnmpMgrRequest solicita que a operação especificada seja executada com o agente especificado. Essa função é um elemento da API de Gerenciamento SNMP.

Sintaxe

SNMPAPI SNMP_FUNC_TYPE SnmpMgrRequest(
  [in]      LPSNMP_MGR_SESSION session,
  [in]      BYTE               requestType,
  [in, out] RFC1157VarBindList *variableBindings,
  [out]     AsnInteger         *errorStatus,
  [out]     AsnInteger         *errorIndex
);

Parâmetros

[in] session

Ponteiro para uma estrutura interna que especifica a sessão que executará a solicitação.

Os aplicativos não devem especificar o ponteiro LPSNMP_MGR_SESSION retornado por essa função em um thread diferente. Você pode especificar um ponteiro retornado por SnmpMgrOpen, mas somente se as chamadas para SnmpMgrOpen e SnmpMgrRequest forem originadas no contexto do mesmo thread.

[in] requestType

Especifica o tipo de solicitação SNMP. Esse parâmetro pode ser um dos seguintes valores definidos pelo SNMPv1.

Valor	Significado
SNMP_PDU_GET	Recupere o valor ou os valores das variáveis especificadas.
SNMP_PDU_GETNEXT	Recupere o valor ou os valores do sucessor lexicográfico da variável especificada.
SNMP_PDU_SET	Escreva um valor dentro de uma variável específica.

 

Observe que os tipos de solicitação de PDU foram renomeados. Para obter informações adicionais, consulte Tipos de variável SNMP e Tipos de PDU de solicitação.

[in, out] variableBindings

Ponteiro para a lista de associações de variáveis.

Nota A matriz SnmpVarBind apontada pela estrutura SnmpVarBindList deve ser alocada usando a função SnmpUtilMemAlloc .

 

[out] errorStatus

Ponteiro para uma variável na qual o erro status resultado será retornado. Esse parâmetro pode ser um dos seguintes valores definidos pelo SNMPv1.

Valor	Significado
SNMP_ERRORSTATUS_NOERROR	O agente relata que nenhum erro ocorreu durante a transmissão.
SNMP_ERRORSTATUS_TOOBIG	O agente não pôde colocar os resultados da operação solicitada em uma única mensagem SNMP.
SNMP_ERRORSTATUS_NOSUCHNAME	A operação solicitada identificou uma variável desconhecida.
SNMP_ERRORSTATUS_BADVALUE	A operação solicitada tentou alterar uma variável, mas especificou uma sintaxe ou um erro de valor.
SNMP_ERRORSTATUS_READONLY	A operação solicitada tentou alterar uma variável que não tinha permissão para ser alterada de acordo com o perfil da comunidade da variável.
SNMP_ERRORSTATUS_GENERR	Ocorreu um erro diferente de um dos listados aqui durante a operação solicitada.

[out] errorIndex

Ponteiro para uma variável na qual o resultado do índice de erro será retornado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError, que pode retornar um dos seguintes códigos de erro.

Código de retorno	Descrição
SNMP_MGMTAPI_TIMEOUT	O tempo limite da solicitação.
SNMP_MGMTAPI_SELECT_FDERRORS	Descritores de arquivo de erro inesperados indicados pela função de seleção de Soquetes do Windows.

Comentários

Repetições e tempos limite são fornecidos para a função SnmpMgrOpen . Cada variável na lista de associações de variáveis deve ser inicializada para digitar ASN_NULL para solicitações Get e Get Next.

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	mgmtapi.h
Biblioteca	Mgmtapi.lib
DLL	Mgmtapi.dll

Confira também

Funções SNMP

Visão geral do Protocolo SNMP

SnmpMgrClose

SnmpMgrOpen