Funzione MprAdminPortGetInfo (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminPortGetInfo ottiene informazioni per una porta specifica.

Sintassi

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

Parametri

[in] hRasServer

Gestire il computer server RAS in cui raccogliere informazioni sulla porta. 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 e 1 come indicato nella tabella seguente.

Valore	Formato struttura
0	RAS_PORT_0
1	RAS_PORT_1

[in] hPort

Gestire la porta per cui raccogliere informazioni. Ottenere questo handle chiamando MprAdminPortEnum.

[out] lplpbBuffer

Al termine, un puntatore a una struttura che descrive la porta. Queste strutture sono di tipo RAS_PORT_0 o RAS_PORT_1 a seconda del valore del parametro dwLevel . Liberare questa memoria chiamando MprAdminBufferFree.

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, 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_INVALID_PORT_HANDLE	Il parametro hPort non è valido.
ERROR_NOT_SUPPORTED	Il parametro dwLevel non è zero.
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 RasAdminPortGetInfo anziché MprAdminPortGetInfo. 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

Vedi anche

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

Funzioni di amministrazione RAS

Informazioni di riferimento per l'amministrazione del servizio accesso remoto

Condividi tramite