Función MprAdminPortEnum (mprapi.h)
La función MprAdminPortEnum enumera todos los puertos activos de una conexión específica, o todos los puertos disponibles para su uso o usados actualmente por RAS.
Sintaxis
DWORD MprAdminPortEnum(
[in] RAS_SERVER_HANDLE hRasServer,
[in] DWORD dwLevel,
[in] HANDLE hRasConnection,
[out] LPBYTE *lplpbBuffer,
[in] DWORD dwPrefMaxLen,
[out] LPDWORD lpdwEntriesRead,
[out] LPDWORD lpdwTotalEntries,
[in] LPDWORD lpdwResumeHandle
);
Parámetros
[in] hRasServer
Identificador del servidor RAS cuyos puertos se van a enumerar. Para obtener este identificador, llame 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.
[in] hRasConnection
Identificador de una conexión para la que se enumeran los puertos activos. Si este parámetro es INVALID_HANDLE_VALUE, se enumeran todos los puertos en uso o disponibles para su uso por parte de RRAS. Para obtener este identificador, llame a MprAdminConnectionEnum.
[out] lplpbBuffer
Al finalizar correctamente, un puntero a una matriz de estructuras de RAS_PORT_0 que describe el puerto. Libere esta memoria llamando a MprAdminBufferFree.
[in] dwPrefMaxLen
Valor que especifica la longitud máxima preferida de los datos devueltos, en bytes de 8 bits. Si este parámetro es -1, el búfer que se devuelve es lo suficientemente grande como para contener todos los datos disponibles.
[out] lpdwEntriesRead
Puntero a una variable DWORD . Esta variable recibe el número total de puertos enumerados a partir de la posición de reanudación actual.
[out] lpdwTotalEntries
Puntero a una variable DWORD . Esta variable recibe el número total de puertos que se podrían haber enumerado desde la posición de reanudación actual.
[in] lpdwResumeHandle
Puntero a una variable DWORD . Si se ejecuta correctamente, este parámetro especifica un identificador que se puede usar para reanudar la enumeración. Este parámetro 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 con el identificador para recuperar más datos. Si el identificador es NULL en la devolución, la enumeración no se puede continuar. Este identificador no es válido para otros tipos de devoluciones de error.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los códigos de error enumerados en la tabla siguiente.
| Valor | Significado |
|---|---|
|
La aplicación que realiza la llamada no tiene privilegios suficientes. |
|
El Administrador de marcado a petición (DDM) no se está ejecutando, posiblemente porque el Administrador de interfaz dinámica (DIM) está configurado para ejecutarse solo en una LAN. |
|
Al menos uno de los parámetros siguientes es NULL o no apunta a una memoria válida: lplpBuffer, lpdwEntriesRead o lpdwTotalEntries. |
|
No todos los datos se devolvieron con esta llamada. Para obtener datos adicionales, vuelva a llamar a la función mediante el identificador que se devolvió en el parámetro IpdwResumeHandle . |
|
El parámetro dwLevel no es cero. |
|
El parámetro hConnection es NULL. |
|
Error de MprError.h, RasError.h o WinError.h. |
Comentarios
Si se instala el redistribuible RRAS, esta función está disponible en Windows NT 4.0. Sin embargo, la versión de Mprapi.dll que se proporciona con el redistribuible RRAS exporta la función como RasAdminPortEnum en lugar de MprAdminPortEnum. Por lo tanto, al usar el redistribuible RRAS, use LoadLibrary y GetProcAddress para acceder a esta función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| 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 |