[New - Windows NT]
The RasAdminPortGetInfo function retrieves information about a specified port on a specified server.
DWORD RasAdminPortGetInfo(
| const WCHAR *lpszServer, | // pointer to the server name |
| const WCHAR *lpszPort, | // pointer to the name of port on the server |
| RAS_PORT_1 *pRasPort1, | // receives the state of the port |
| RAS_PORT_STATISTICS *pRasStats, | // receives statistics about the port |
| RAS_PARAMETERS **ppRasParams | // receives an array of media-specific parameters and values |
| ); |
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.
lpszPort
Pointer to a null-terminated Unicode string that contains the name of the port on the server.
pRasPort1
Pointer to a RAS_PORT_1 structure that the function fills in with information about the state of the port.
pRasStats
Pointer to a RAS_PORT_STATISTICS structure that the function fills in with statistics about the port.
ppRasParams
Pointer to a variable that receives a pointer to an array of RAS_PARAMETERS structures. Each structure contains the name of a media-specific key, such as MAXCONNECTBPS, and its associated value. When your application is finished with the memory pointed to by *ppRasParams, free it by calling the RasAdminFreeBuffer function.
Return Values
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value can be one of the following error codes.
| Value | Meaning |
| ERROR_DEV_NOT_EXIST | The specified port is invalid. |
| ERROR_NOT_ENOUGH_MEMORY | Insufficient memory to allocate a buffer for the ppRasParams array. |
Do not call GetLastError to get error information for this function.
See Also
RAS_PARAMETERS, RAS_PORT_1, RAS_PORT_STATISTICS, RasAdminFreeBuffer