Función MprAdminInterfaceEnum (mprapi.h)
La función MprAdminInterfaceEnum enumera todas las interfaces de un servidor especificado.
Sintaxis
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
);
Parámetros
[in] hMprServer
Controle al enrutador en el que se va a ejecutar esta llamada. Obtenga este identificador llamando a MprAdminServerConnect.
[in] dwLevel
Valor DWORD que describe el formato en el que se devuelve la información en el parámetro lplpbBuffer . Debe ser cero.
[out] lplpbBuffer
Al finalizar correctamente, un puntero a una matriz de estructuras MPR_INTERFACE_0 . Libere este búfer de memoria llamando a MprAdminBufferFree.
[in] dwPrefMaxLen
Especifica la longitud máxima preferida de los datos devueltos (en bytes de 8 bits). Si este parámetro es -1, el búfer devuelto es lo suficientemente grande como para contener toda la información disponible.
[out] lpdwEntriesRead
Puntero a una variable DWORD . Esta variable recibe el número total de interfaces enumeradas de la posición actual en la enumeración.
[out] lpdwTotalEntries
Puntero a una variable DWORD . Esta variable recibe el número total de interfaces que se podrían haber enumerado a partir de la posición de reanudación actual.
[in] lpdwResumeHandle
Puntero a una variable DWORD . Esta variable especifica un identificador de reanudación que se puede usar para continuar con la enumeración. El identificador debe ser cero en la primera llamada y dejar sin cambios en las llamadas posteriores. Si el código devuelto se ERROR_MORE_DATA, la llamada se puede volver a emitir mediante el identificador para recuperar más datos. Si se devuelve, el identificador es NULL, la enumeración no se puede continuar. Para otros tipos de devoluciones de error, este identificador no es válido.
Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no devuelve un identificador de reanudación.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
La aplicación que realiza la llamada no tiene privilegios suficientes. |
|
Hay más información disponible; la enumeración se puede continuar. |
|
Recursos insuficientes para completar la operación. |
|
El valor de dwLevel no es válido. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mprapi.h |
| Library | Mprapi.lib |
| Archivo DLL | Mprapi.dll |