Funzione MprAdminMIBEntryGetFirst (mprapi.h)

Articolo
03/05/2024

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

Sintassi

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

Parametri

[in] hMibServer

Gestire il router su cui eseguire questa chiamata. Ottenere questo handle chiamando 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 manutenzione della chiamata. La struttura dei dati deve contenere informazioni che specificano la variabile sottoposta a query.

[in] dwInEntrySize

Specifica le dimensioni, in byte, dei 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 manutenzione della chiamata. La struttura dei dati riceve il valore della prima variabile dal set di variabili esportate. Liberare questa memoria chiamando MprAdminMIBBufferFree.

[out] lpOutEntrySize

Puntatore a una variabile DWORD . Al termine della restituzione, 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 alcun gestore trasporto/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

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