Función RasAdminPortGetInfo

[Esta función solo se proporciona para la compatibilidad con versiones anteriores con Windows NT Server 4.0. Devuelve ERROR_CALL_NOT_IMPLEMENTED en Windows Server 2003. Las aplicaciones deben usar la función MprAdminPortGetInfo .]

La función RasAdminPortGetInfo recupera información sobre un puerto especificado en un servidor especificado.

Sintaxis

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

Parámetros

lpszServer [in]

Puntero a una cadena Unicode terminada en null que especifica el nombre del servidor RAS. Especifique el nombre con caracteres "\\" iniciales, con el formato \\nombreServidor.

lpszPort [in]

Puntero a una cadena Unicode terminada en null que especifica el nombre del puerto en el servidor.

pRasPort1 [out]

Puntero a la estructura RAS_PORT_1 que la función rellena con información sobre el estado del puerto.

pRasStats [out]

Puntero a la estructura RAS_PORT_STATISTICS que la función rellena con estadísticas sobre el puerto.

ppRasParams [out]

Puntero a una variable de puntero que recibe la dirección de una matriz de estructuras de RAS_PARAMETERS . Cada estructura contiene el nombre de una clave específica del medio, como MAXCONNECTBPS, y su valor asociado. Cuando la aplicación termine con esta memoria, liberela llamando a la función RasAdminFreeBuffer .

Valor devuelto

Si la función se realiza correctamente, se ERROR_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Valor Significado
ERROR_DEV_NOT_EXIST
El puerto especificado no es válido.
ERROR_NOT_ENOUGH_MEMORY
Memoria insuficiente para asignar un búfer para la matriz ppRasParams .

No hay información de error extendida para esta función; no llame a GetLastError.

Requisitos

Requisito Valor
Fin de compatibilidad de cliente
Windows 2000 Professional
Fin de compatibilidad de servidor
Windows 2000 Server
Encabezado
Rassapi.h
Biblioteca
Rassapi.lib
Archivo DLL
Rassapi.dll

Consulte también

Información general sobre el servicio de acceso remoto (RAS)

Funciones de administración del servidor RAS

RAS_PARAMETERS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminFreeBuffer