Condividi tramite


Funzione GetUdpTable (iphlpapi.h)

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:

  1. Indirizzo IP locale
  2. 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

Vedi anche

GetExtendedUdpTable

GetOwnerModuleFromUdp6Entry

GetOwnerModuleFromUdpEntry

GetUdp6Table

GetUdpStatistics

GetUdpStatisticsEx

MIB_UDPROW

MIB_UDPROW_OWNER_MODULE

MIB_UDPROW_OWNER_PID

MIB_UDPTABLE

MIB_UDPTABLE_OWNER_MODULE

MIB_UDPTABLE_OWNER_PID