Funzione GetUdpTable (iphlpapi.h)

Articolo
08/24/2023

La funzione GetUdpTable recupera la tabella del listener IPv4 User Datagram Protocol (UDP).

Sintassi

IPHLPAPI_DLL_LINKAGE ULONG GetUdpTable(
  [out]     PMIB_UDPTABLE UdpTable,
  [in, out] PULONG        SizePointer,
  [in]      BOOL          Order
);

Parametri

[out] UdpTable

Puntatore a un buffer che riceve la tabella listener UDP IPv4 come struttura MIB_UDPTABLE .

[in, out] SizePointer

In input specifica le dimensioni in byte del buffer a cui punta il parametro UdpTable .

In output, se il buffer non è abbastanza grande per contenere la tabella listener restituita, la funzione imposta questo parametro uguale alle dimensioni del buffer necessarie in byte.

In Windows SDK rilasciato per Windows Vista e versioni successive, il tipo di dati per questo parametro viene modificato in un PULONG equivalente a un PDWORD.

[in] Order

Valore booleano che specifica se la tabella di listener UDP restituita deve essere ordinata. Se questo parametro è TRUE, la tabella viene ordinata nell'ordine di:

Indirizzo IP locale
Porta locale

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.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Il buffer a cui punta il parametro pUdpTable non è sufficiente. Le dimensioni necessarie vengono restituite nella variabile ULONG a cui punta il parametro pdwSize . Questo errore viene restituito anche se il parametro pUdpTable è NULL.
ERROR_INVALID_PARAMETER	Il parametro pdwSize è NULL o GetUdpTable non è in grado di scrivere nella memoria a cui punta il parametro pdwSize .
ERROR_NOT_SUPPORTED	Questa funzione non è supportata nel sistema operativo in uso nel sistema locale.
Altri	Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

In Windows SDK rilasciato per Windows Vista e versioni successive, il valore restituito dalla funzione GetUdpTable viene modificato in un tipo di dati di ULONG equivalente a una DWORD.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll