The MprAdminPortEnum function enumerates all active ports in a specific connection, or all ports available for use or currently used by RAS.

Syntax

DWORD MprAdminPortEnum(
  __in   RAS_SERVER_HANDLE hRasServer,
  __in   DWORD dwLevel,
  __in   HANDLE hConnection,
  __out  LPBYTE *lplpbBuffer,
  __in   DWORD dwPrefMaxLen,
  __out  LPDWORD lpdwEntriesRead,
  __out  LPDWORD lpdwTotalEntries,
  __in   LPDWORD lpdwResumeHandle
);

Parameters

hRasServer [in]

A handle to the RAS server whose ports are to be enumerated. To obtain this handle, call MprAdminServerConnect.

dwLevel [in]

A DWORD value that describes the format in which the information is returned in the lplpbBuffer parameter. Must be zero.

hConnection [in]

A handle to a connection for which the active ports are enumerated. If this parameter is INVALID_HANDLE_VALUE, all the ports in use or available for use by RRAS are enumerated. To obtain this handle, call MprAdminConnectionEnum.

lplpbBuffer [out]

On successful completion, a pointer to an array of RAS_PORT_0 structures that describes the port. Free this memory by calling MprAdminBufferFree.

dwPrefMaxLen [in]

A value that specifies the preferred maximum length of returned data, in 8-bit bytes. If this parameter is -1, the buffer that is returned is large enough to hold all available data.

lpdwEntriesRead [out]

A pointer to a DWORD variable. This variable receives the total number of ports that are enumerated from the current resume position.

lpdwTotalEntries [out]

A pointer to a DWORD variable. This variable receives the total number of ports that could have been enumerated from the current resume position.

lpdwResumeHandle [in]

A pointer to a DWORD variable. On successful execution, this parameter specifies a handle that can be used to resume the enumeration. This parameter should be zero on the first call and left unchanged on subsequent calls. If the return code is ERROR_MORE_DATA, the call can be reissued with the handle to retrieve more data. If the handle is NULL on return, the enumeration cannot be continued. This handle is invalid for other types of error returns.

Return Value

If the function succeeds, the return value is NO_ERROR.

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

Remarks

If the RRAS redistributable is installed, this function is available on Windows NT 4.0. However, the version of Mprapi.dll that is provided with the RRAS redistributable exports the function as RasAdminPortEnum rather than MprAdminPortEnum. Therefore, when using the RRAS redistributable, use LoadLibrary and GetProcAddress to access this function.

Requirements

See Also

Remote Access Service Administration Reference

RAS Administration Functions

MprAdminBufferFree

MprAdminServerConnect

MprAdminConnectionEnum

Send comments about this topic to Microsoft

Build date: 11/19/2009