RasAdminPortEnum

[New - Windows NT]

The RasAdminPortEnum function enumerates all ports on the specified RAS server. For each port on the server, the function returns a RAS_PORT_0 structure that contains information about the port.

DWORD RasAdminPortEnum(

const WCHAR *lpszServer, // pointer to the server name
PRAS_PORT_0 *ppRasPort0, // receives a pointer to an array of port information
WORD *pcEntriesRead // receives the number of ports enumerated
);  

Parameters

lpszServer

Pointer to a null-terminated Unicode string that contains the name of the Windows NT RAS server. Specify the name with leading "\\" characters, in the form: \\servername.

ppRasPort0

Pointer to a variable that receives a pointer to a buffer that contains an array of RAS_PORT_0 structures. When your application has finished with the memory, free it by calling the RasAdminFreeBuffer function.

pcEntriesRead

Pointer to a 16-bit variable that receives the total number of RAS_PORT_0 structures returned in the ppRasPort0 array.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value can be the following error code.

Value Meaning
NERR_ItemNotFound No ports could be enumerated. This could be because all configured ports on the server are currently being used for dialing out.

Do not call GetLastError to get error information for this function.

See Also

RAS_PORT_0, RasAdminFreeBuffer