Função MprAdminMIBEntryGetFirst (mprapi.h)

Artigo
02/29/2024

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

Sintaxe

DWORD MprAdminMIBEntryGetFirst(
  [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. Obtenha esse identificador chamando 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, dos dados apontados 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 primeira variável do conjunto de variáveis exportadas. Libere essa memória chamando MprAdminMIBBufferFree.

[out] lpOutEntrySize

Ponteiro para uma variável DWORD . No retorno bem-sucedido, essa variável recebe o tamanho, em bytes, da estrutura de dados que foi retornada por meio do parâmetro lplpOutEntry .

Retornar valor

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 transporte/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

Requisito	Valor
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