MprAdminConnectionGetInfoEx function

The MprAdminConnectionGetInfoEx function retrieves the connection information for a specific connection on a specified RRAS server.

Syntax


DWORD APIENTRY MprAdminConnectionGetInfoEx(
  _In_  RAS_SERVER_HANDLE  hRasServer,
  _In_  HANDLE             hConnection,
  _Out_ PRAS_CONNECTION_EX pRasConnection
);

Parameters

hRasServer [in]

A handle to the computer from which the connection information is retrieved. To obtain this handle, call MprAdminServerConnect.

hConnection [in]

A handle to the connection to retrieve data about. To obtain this handle, call MprAdminConnectionEnum.

pRasConnection [out]

A pointer, on output, to a RAS_CONNECTION_EX structure that contains the connection information for the RRAS server in hRasServer.

To free this memory, call MprAdminBufferFree.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

ValueMeaning
ERROR_ACCESS_DENIED

The calling application does not have sufficient privileges.

ERROR_DDM_NOT_RUNNING

The Demand Dial Manager (DDM) is not running.

ERROR_PROC_NOT_FOUND

The specified procedure could not be found.

Other

An error from MprError.h, RasError.h, or WinError.h.

 

Remarks

The caller should free the memory pointed to by pRasConnection by calling the function MprAdminBufferFree.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mprapi.h

Library

Mprapi.lib

DLL

Mprapi.dll

See also

Remote Access Service Administration Reference
RAS Administration Functions
MprAdminBufferFree
MprAdminConnectionGetInfo
MprAdminConnectionEnum

 

 

Community Additions

ADD
Show: