Función RasAdminPortEnum

[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 MprAdminPortEnum .]

La función RasAdminPortEnum enumera todos los puertos del servidor RAS especificado. Para cada puerto del servidor, la función devuelve la estructura RAS_PORT_0 que contiene información sobre el puerto.

Sintaxis

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

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.

ppRasPort0 [out]

Puntero a una variable que recibe un puntero a un búfer que contiene una matriz de estructuras RAS_PORT_0 . Cuando la aplicación haya terminado con la memoria, liberela llamando a la función RasAdminFreeBuffer .

pcEntriesRead [out]

Puntero a una variable de 16 bits que recibe el número total de estructuras de RAS_PORT_0 devueltas en la matriz ppRasPort0 .

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 el siguiente código de error.

Valor	Significado
NERR_ItemNotFound	No se pudo enumerar ningún puerto. Esto podría deberse a que todos los puertos configurados del servidor se están usando actualmente para el marcado.

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	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_PORT_0

RasAdminFreeBuffer