Función MprAdminPortGetInfo (mprapi.h)
La función MprAdminPortGetInfo obtiene información de un puerto específico.
Sintaxis
DWORD MprAdminPortGetInfo(
[in] RAS_SERVER_HANDLE hRasServer,
[in] DWORD dwLevel,
[in] HANDLE hPort,
[out] LPBYTE *lplpbBuffer
);
Parámetros
[in] hRasServer
Controlar en el equipo servidor RAS en el que se va a recopilar información de puerto. 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 . Los valores aceptables para dwLevel incluyen 0 y 1, como se muestra en la tabla siguiente.
| Valor | Formato de estructura |
|---|---|
| 0 | RAS_PORT_0 |
| 1 | RAS_PORT_1 |
[in] hPort
Identificador del puerto para el que se va a recopilar información. Obtenga este identificador llamando a MprAdminPortEnum.
[out] lplpbBuffer
Al finalizar correctamente, un puntero a una estructura que describe el puerto. Estas estructuras son de tipo RAS_PORT_0 o RAS_PORT_1 en función del valor del parámetro dwLevel . Libere esta memoria llamando a MprAdminBufferFree.
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 siguientes códigos de error.
| 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 interfaces dinámicas (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. |
|
El parámetro hPort no es válido. |
|
El parámetro dwLevel no es cero. |
|
Error de MprError.h, RasError.h o WinError.h. |
Comentarios
Esta función está disponible en Windows NT 4.0 si está instalado el redistribuible RRAS. Sin embargo, la versión de Mprapi.dll que se incluye con el redistribuible RRAS exporta la función como RasAdminPortGetInfo en lugar de MprAdminPortGetInfo. 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 |