Funzione MprAdminPortEnum (mprapi.h)

Articolo
03/15/2023

La funzione MprAdminPortEnum enumera tutte le porte attive in una connessione specifica o tutte le porte disponibili per l'uso o attualmente usate da RAS.

Sintassi

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

Parametri

[in] hRasServer

Handle per il server RAS le cui porte devono essere enumerate. Per ottenere questo handle, chiamare MprAdminServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpbBuffer . Deve essere zero.

[in] hRasConnection

Handle a una connessione per la quale vengono enumerate le porte attive. Se questo parametro è INVALID_HANDLE_VALUE, vengono enumerate tutte le porte in uso o disponibili per l'uso da parte di RRAS. Per ottenere questo handle, chiamare MprAdminConnectionEnum.

[out] lplpbBuffer

Al termine, un puntatore a una matrice di strutture RAS_PORT_0 che descrive la porta. Liberare questa memoria chiamando MprAdminBufferFree.

[in] dwPrefMaxLen

Valore che specifica la lunghezza massima preferita dei dati restituiti, in byte a 8 bit. Se questo parametro è -1, il buffer restituito è sufficientemente grande da contenere tutti i dati disponibili.

[out] lpdwEntriesRead

Puntatore a una variabile DWORD . Questa variabile riceve il numero totale di porte enumerate dalla posizione di ripresa corrente.

[out] lpdwTotalEntries

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

[in] lpdwResumeHandle

Puntatore a una variabile DWORD . Al termine dell'esecuzione, questo parametro specifica un handle che può essere utilizzato per riprendere l'enumerazione. Questo parametro deve essere zero nella prima chiamata e lasciato invariato nelle chiamate successive. Se il codice restituito è ERROR_MORE_DATA, la chiamata può essere ristampata con l'handle per recuperare altri dati. Se l'handle è NULL in caso di restituzione, l'enumerazione non può essere continuata. Questo handle non è valido per altri tipi di errore restituiti.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore elencati nella tabella seguente.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
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_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 restituito nel parametro IpdwResumeHandle .
ERROR_NOT_SUPPORTED	Il parametro dwLevel non è zero.
ERROR_INVALID_HANDLE	Il parametro hConnection è NULL.
Altri	Errore da MprError.h, RasError.h o WinError.h.

Commenti

Se RRAS redistributable è installato, questa funzione è disponibile in Windows NT 4.0. Tuttavia, la versione di Mprapi.dll fornita con RRAS redistributable esporta la funzione come RasAdminPortEnum anziché MprAdminPortEnum. Pertanto, quando si usa RRAS redistributable, 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

Vedi anche

MprAdminBufferFree

MprAdminConnectionEnum

MprAdminServerConnect

Funzioni di amministrazione RAS

Informazioni di riferimento per l'amministrazione del servizio Accesso remoto

Condividi tramite