Função MprAdminMIBEntryGetNext (mprapi.h)

Artigo
08/24/2023

A função MprAdminMIBEntryGetNext recupera a próxima variável de algum conjunto de variáveis exportadas por um protocolo ou gerenciador de roteadores. O módulo que atende à chamada define a seguir.

Sintaxe

DWORD MprAdminMIBEntryGetNext(
  [in]  MIB_SERVER_HANDLE hMibServer,
  [in]  DWORD             dwProtocolId,
  [in]  DWORD             dwRoutingPid,
  [in]  LPVOID            lpInEntry,
  [in]  DWORD             dwInEntrySize,
  [out] LPVOID            *lplpOutEntry,
  [out] LPDWORD           lpOutEntrySize
);

Parâmetros

[in] hMibServer

Manipule para o roteador no qual executar essa chamada. Esse identificador é obtido de uma chamada anterior para MprAdminMIBServerConnect.

[in] dwProtocolId

Especifica o gerenciador de roteador que exportou a variável.

[in] dwRoutingPid

Especifica o protocolo de roteamento que exportou a variável.

[in] lpInEntry

Ponteiro para uma estrutura de dados opaca. O formato da estrutura de dados é determinado pelo módulo que atende à chamada. A estrutura de dados deve conter informações que especificam a variável que está sendo consultada.

[in] dwInEntrySize

Especifica o tamanho, em bytes, da estrutura de dados apontada por lpInEntry.

[out] lplpOutEntry

Ponteiro para uma variável de ponteiro. No retorno bem-sucedido, essa variável de ponteiro aponta para uma estrutura de dados opaca. O formato da estrutura de dados é determinado pelo módulo que atende à chamada. A estrutura de dados recebe o valor da próxima variável do conjunto de variáveis exportadas. Libere essa memória chamando MprAdminMIBBufferFree.

[out] lpOutEntrySize

Ponteiro para uma variável DWORD . Essa variável recebe o tamanho em bytes da estrutura de dados retornada por meio do parâmetro lplpOutEntry .

Valor retornado

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

Se a função falhar, o valor retornado será um dos valores a seguir.

Valor	Descrição
ERROR_ACCESS_DENIED	O chamador não tem privilégios suficientes.
ERROR_CANNOT_COMPLETE	A variável dwRoutingPid não corresponde a nenhum protocolo de roteamento instalado.
ERROR_UNKNOWN_PROTOCOL_ID	O valor dwTransportId não corresponde a nenhum gerenciador de roteador instalado.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.

Comentários

Não passe NULL para o parâmetro lpInEntry porque o comportamento resultante é indefinido.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll