Funzione MprAdminPortGetInfo (mprapi.h)

  • Articolo

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