Funzione MprAdminMIBEntryGetNext (mprapi.h)

Articolo
03/15/2023

La funzione MprAdminMIBEntryGetNext recupera la variabile successiva di alcuni set di variabili esportate da un protocollo o da una gestione router. Il modulo che esegue il servizio della chiamata definisce successivamente.

Sintassi

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
);

Parametri

[in] hMibServer

Gestire il router su cui eseguire questa chiamata. Questo handle viene ottenuto da una chiamata precedente a MprAdminMIBServerConnect.

[in] dwProtocolId

Specifica la gestione router che ha esportato la variabile.

[in] dwRoutingPid

Specifica il protocollo di routing che ha esportato la variabile.

[in] lpInEntry

Puntatore a una struttura di dati opaca. Il formato della struttura dei dati è determinato dal modulo che esegue la chiamata. La struttura dei dati deve contenere informazioni che specificano la variabile sottoposta a query.

[in] dwInEntrySize

Specifica le dimensioni, in byte, della struttura di dati a cui punta lpInEntry.

[out] lplpOutEntry

Puntatore a una variabile puntatore. Al termine della restituzione, questa variabile puntatore punta a una struttura di dati opaca. Il formato della struttura dei dati è determinato dal modulo che esegue la chiamata. La struttura dei dati riceve il valore della variabile successiva dal set di variabili esportate. Liberare questa memoria chiamando MprAdminMIBBufferFree.

[out] lpOutEntrySize

Puntatore a una variabile DWORD . Questa variabile riceve le dimensioni in byte della struttura di dati restituita tramite il parametro lplpOutEntry .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei valori seguenti.

Valore	Descrizione
ERROR_ACCESS_DENIED	Il chiamante non dispone di privilegi sufficienti.
ERROR_CANNOT_COMPLETE	La variabile dwRoutingPid non corrisponde a alcun protocollo di routing installato.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde a nessun gestore router installato.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.

Commenti

Non passare NULL per il parametro lpInEntry perché il comportamento risultante non è definito.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll