Funzione MprAdminConnectionEnumEx (mprapi.h)

Articolo
08/24/2023

La funzione MprAdminConnectionEnumEx enumera le connessioni attive per un server RRAS specificato.

Sintassi

DWORD MprAdminConnectionEnumEx(
  [in]  RAS_SERVER_HANDLE     hRasServer,
  [in]  PMPRAPI_OBJECT_HEADER pObjectHeader,
  [in]  DWORD                 dwPreferedMaxLen,
  [out] LPDWORD               lpdwEntriesRead,
  [out] LPDWORD               lpdwTotalEntries,
  [out] PRAS_CONNECTION_EX    *ppRasConn,
  [in]  LPDWORD               lpdwResumeHandle
);

Parametri

[in] hRasServer

Handle al server RAS in cui vengono enumerate le connessioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] pObjectHeader

Puntatore a una struttura MPRAPI_OBJECT_HEADER che specifica la versione della struttura ricevuta da ppRasConn.

[in] dwPreferedMaxLen

Valore che specifica la lunghezza massima preferita dei dati restituiti in byte a 8 bit. Se dwPrefMaxLen è -1, il buffer restituito è abbastanza grande per contenere tutte le informazioni disponibili.

[out] lpdwEntriesRead

Puntatore a un DWORD che riceve il numero totale di connessioni enumerate dalla posizione di ripresa corrente.

[out] lpdwTotalEntries

Puntatore a un DWORD che riceve il numero totale di connessioni che potrebbero essere state enumerate dalla posizione di ripresa corrente.

[out] ppRasConn

Puntatore, in output, a una matrice di strutture RAS_CONNECTION_EX che contengono le informazioni di connessione attive per il server RRAS in hRasServer. Il numero di elementi della matrice è determinato dal valore a cui punta lpdwEntriesRead.

[in] lpdwResumeHandle

Puntatore a una variabile DWORD che specifica un handle di ripresa usato per continuare l'enumerazione. Il parametro lpdwResumeHandle è NULL nella prima chiamata e lasciato invariato nelle chiamate successive. Se il codice restituito è ERROR_MORE_DATA, è possibile eseguire un'altra chiamata usando questo handle per recuperare altri dati. Se l'handle è NULL al ritorno, l'enumerazione viene completata. Questo handle non è valido per altri tipi di errore restituiti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_DDM_NOT_RUNNING	Demand Dial Manager (DDM) non è in esecuzione.
ERROR_MORE_DATA	Non tutti i dati sono stati restituiti con questa chiamata. Per ottenere dati aggiuntivi, chiamare di nuovo la funzione usando l'handle di ripresa.
ERROR_PROC_NOT_FOUND	Impossibile trovare la procedura specificata.
Altri	Errore da MprError.h, RasError.h o WinError.h.

Commenti

Il chiamante deve liberare la memoria puntata da ppRasConn chiamando la funzione MprAdminBufferFree.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll