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 \\servername.
-
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 haya terminado con esta memoria, ábrela llamando a la función RasAdminFreeBuffer .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
El puerto especificado no es válido. |
|
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 | Value |
|---|---|
| Fin de compatibilidad de cliente |
Windows 2000 Professional |
| Fin de compatibilidad de servidor |
Windows 2000 Server |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|