Funzione MprAdminInterfaceEnum (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminInterfaceEnum enumera tutte le interfacce in un server specificato.

Sintassi

DWORD MprAdminInterfaceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [in]  DWORD             dwPrefMaxLen,
  [out] LPDWORD           lpdwEntriesRead,
  [out] LPDWORD           lpdwTotalEntries,
  [in]  LPDWORD           lpdwResumeHandle
);

Parametri

[in] hMprServer

Gestire il router su cui eseguire questa chiamata. Ottenere questo handle chiamando MprAdminServerConnect.

[in] dwLevel

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

[out] lplpbBuffer

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

[in] dwPrefMaxLen

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

[out] lpdwEntriesRead

Puntatore a una variabile DWORD . Questa variabile riceve il numero totale di interfacce enumerate dalla posizione corrente nell'enumerazione .

[out] lpdwTotalEntries

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

[in] lpdwResumeHandle

Puntatore a una variabile DWORD . Questa variabile specifica un handle di ripresa che può essere utilizzato per continuare l'enumerazione. L'handle deve essere zero nella prima chiamata e lasciare invariato nelle chiamate successive. Se il codice restituito è ERROR_MORE_DATA, è possibile eseguire nuovamente la chiamata usando l'handle per recuperare altri dati. Se in caso di restituzione, l'handle è NULL, l'enumerazione non può essere continuata. Per altri tipi di errore, 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_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_MORE_DATA	Altre informazioni sono disponibili; l'enumerazione può essere continuata.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NOT_SUPPORTED	Il valore di dwLevel non è valido.

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

MPR_INTERFACE_0

MprAdminBufferFree

MprAdminServerConnect

Funzioni di amministrazione router

Informazioni di riferimento sulla gestione dei router

Condividi tramite