Funzione MprConfigInterfaceEnum (mprapi.h)

Articolo
02/29/2024

La funzione MprConfigInterfaceEnum enumera le interfacce configurate per il router.

Sintassi

DWORD MprConfigInterfaceEnum(
  [in]                HANDLE  hMprConfig,
  [in]                DWORD   dwLevel,
  [in, out]           LPBYTE  *lplpBuffer,
  [in]                DWORD   dwPrefMaxLen,
  [out]               LPDWORD lpdwEntriesRead,
  [out]               LPDWORD lpdwTotalEntries,
  [in, out, optional] LPDWORD lpdwResumeHandle
);

Parametri

[in] hMprConfig

Gestire la configurazione del router. Ottenere questo handle chiamando MprConfigServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpBuffer . Deve essere zero.

[in, out] lplpBuffer

In input, un puntatore non NULL .

Al termine, un puntatore a una matrice di strutture MPR_INTERFACE_0 . Liberare questo buffer di memoria chiamando MprConfigBufferFree.

[in] dwPrefMaxLen

Specifica la lunghezza massima preferita dei dati restituiti (in byte a 8 bit). Se questo parametro è -1, il buffer restituito sarà sufficientemente grande da contenere tutte le informazioni disponibili.

[out] lpdwEntriesRead

Puntatore a una variabile DWORD . Questa variabile riceve il numero totale di voci enumerate dalla posizione di ripresa corrente.

[out] lpdwTotalEntries

Puntatore a una variabile DWORD . Questa variabile riceve il numero totale di voci che potrebbero essere state enumerate dalla posizione di ripresa corrente.

[in, out, optional] lpdwResumeHandle

Puntatore a una variabile DWORD .

In input, l'handle deve essere zero nella prima chiamata e lasciare invariato nelle chiamate successive per continuare l'enumerazione.

Nell'output contiene un handle di ripresa che può essere usato per continuare l'enumerazione. Se l'handle è NULL, l'enumerazione è completa.

Se si verifica un errore nell'enumerazione , questo handle non è valido.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non restituisce un handle di ripresa.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Una delle seguenti condizioni è vera: hMprConfig è NULL. dwLevel non è zero. lplpBuffer è NULL. dwPrefMaxLen è inferiore alla dimensione di una singola struttura MPR_INTERFACE_0 . lpdwEntriesRead è NULL. lpdwTotalEntries è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NO_MORE_ITEMS	Nessuna voce disponibile dalla posizione di ripresa corrente.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

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

Vedi anche

FormatMessage

MprConfigBufferFree

MprConfigServerConnect

Funzioni di configurazione del router

Informazioni di riferimento sulla gestione dei router

Condividi tramite