Funzione MprAdminTransportGetInfo (mprapi.h)

Articolo
08/24/2023

La funzione MprAdminTransportGetInfo recupera informazioni globali, informazioni sull'interfaccia client predefinite o entrambe per un trasporto specificato.

Sintassi

DWORD MprAdminTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            DWORD             dwTransportId,
  [out, optional] LPBYTE            *ppGlobalInfo,
  [out, optional] LPDWORD           lpdwGlobalInfoSize,
  [out, optional] LPBYTE            *ppClientInterfaceInfo,
  [out, optional] LPDWORD           lpdwClientInterfaceInfoSize
);

Parametri

[in] hMprServer

Gestire il router da cui vengono recuperate le informazioni. Questo handle viene ottenuto da una chiamata precedente a MprAdminServerConnect.

[in] dwTransportId

Valore DWORD che descrive il tipo di trasporto da recuperare. I valori accettabili per dwTransportId sono elencati nella tabella seguente.

Valore	Trasporto (famiglia di protocolli)
PID_ATALK	Appletalk
PID_IP	Internet Protocol versione 4
PID_IPX	Scambio pacchetti Internet
PID_NBF	Protocollo Frame NetBIOS
PID_IPV6	Windows Server 2008 o versione successiva: Protocollo Internet versione 6

[out, optional] ppGlobalInfo

Puntatore a una variabile puntatore. Questa variabile punta a un'intestazione di informazioni che riceve informazioni globali per questo trasporto. Usare le funzioni di intestazione informazioni per modificare le intestazioni di informazioni.

Liberare questa memoria chiamando MprAdminBufferFree.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non recupera le informazioni globali.

[out, optional] lpdwGlobalInfoSize

Puntatore a una variabile DWORD . Questa variabile riceve le dimensioni, in byte, delle informazioni globali per il trasporto.

[out, optional] ppClientInterfaceInfo

Puntatore a una variabile puntatore. Questa variabile punta alle informazioni predefinite sull'interfaccia client per questo trasporto. Liberare questa memoria chiamando MprAdminBufferFree.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non recupera le informazioni sull'interfaccia client.

[out, optional] lpdwClientInterfaceInfoSize

Puntatore a una variabile DWORD . Questa variabile riceve le dimensioni, in byte, delle informazioni sull'interfaccia client.

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_INVALID_PARAMETER	Una delle seguenti condizioni è vera: Il parametro ppGlobalInfo e il parametro ppClientInterfaceInfo sono entrambi NULL. Il parametro ppGlobalInfo non punta alla memoria valida. Il parametro ppClientInterfaceInfo non punta alla memoria valida.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde a alcun trasporto installato.

Commenti

I parametri ppGlobalInfo e ppClientInterfaceInfo non possono essere NULL.

Requisiti

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