Funzione MprAdminConnectionEnum (mprapi.h)

Articolo
08/24/2023

La funzione MprAdminConnectionEnum enumera tutte le connessioni attive.

Sintassi

DWORD MprAdminConnectionEnum(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [in]  DWORD             dwPrefMaxLen,
  [out] LPDWORD           lpdwEntriesRead,
  [out] LPDWORD           lpdwTotalEntries,
  [in]  LPDWORD           lpdwResumeHandle
);

Parametri

[in] hRasServer

Gestire il server RAS in cui vengono enumerate le connessioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpbBuffer . I valori accettabili per dwLevel includono 0, 1, 2 e 3, come indicato nella tabella seguente.

Windows NT 4.0: Questo parametro deve essere zero.

Valore	Formato struttura
0	RAS_CONNECTION_0
1	Windows 2000 o versione successiva: RAS_CONNECTION_1
2	Windows 2000 o versione successiva: RAS_CONNECTION_2
3	Windows Server 2008 o versione successiva: RAS_CONNECTION_3

[out] lplpbBuffer

Al termine del completamento, un puntatore a una matrice di strutture che descrivono la connessione. Queste strutture sono di tipo RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 o RAS_CONNECTION_3, a seconda del valore del parametro dwLevel .

Per liberare questa memoria, chiamare MprAdminBufferFree.

[in] dwPrefMaxLen

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 una variabile DWORD . Questa variabile riceve il numero totale di connessioni enumerate dalla posizione di ripresa corrente.

[out] lpdwTotalEntries

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

[in] lpdwResumeHandle

Puntatore a una variabile DWORD . Questa variabile specifica un handle di ripresa usato per continuare l'enumerazione. Il parametro lpdwResumeHandle è zero 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_DDM_NOT_RUNNING	Demand Dial Manager (DDM) non è in esecuzione, probabilmente perché Dynamic Interface Manager (DIM) è configurato per l'esecuzione solo in una LAN.
ERROR_INVALID_LEVEL	Il valore passato per dwLevel non è zero, uno, due o tre. I livelli uno e due sono supportati solo in Windows 2000 o versioni successive. Il livello tre è supportato solo in Windows Server 2008 o versioni successive.
ERROR_INVALID_PARAMETER	Almeno uno dei parametri seguenti è NULL o non punta alla memoria valida: lplpBuffer, lpdwEntriesRead o lpdwTotalEntries.
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.
RPC_S_INVALID_BINDING	L'handle passato nel parametro hRasServer è NULL o non valido.
Altri	Errore da MprError.h, RasError.h o WinError.h.

Commenti

Questa funzione è disponibile in Windows NT 4.0 se la ridistribuibile RRAS è installata. Tuttavia, la versione di Mprapi.dll fornita con RRAS ridistribuibile esporta la funzione come RasAdminConnectionEnum anziché MprAdminConnectionEnum. Pertanto, quando si usa RRAS ridistribuibile, usare LoadLibrary e GetProcAddress per accedere a questa funzione.

Requisiti

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