Condividi tramite


Funzione GetIpErrorString (iphlpapi.h)

La funzione GetIpErrorString recupera una stringa di errore dell'helper IP.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD GetIpErrorString(
  [in]      IP_STATUS ErrorCode,
  [out]     PWSTR     Buffer,
  [in, out] PDWORD    Size
);

Parametri

[in] ErrorCode

Codice di errore da recuperare. I valori possibili per questo parametro sono definiti nel file di intestazione Ipexport.h .

[out] Buffer

Puntatore al buffer contenente la stringa del codice di errore se la funzione restituisce con NO_ERROR.

[in, out] Size

Puntatore a un DWORD che specifica la lunghezza, in caratteri, del buffer a cui punta il parametro Buffer , escluso il valore Null di terminazione, ad esempio la dimensione di Buffer in caratteri meno uno.

Valore restituito

Restituisce NO_ERROR in caso di esito positivo.

Se la funzione ha esito negativo, usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

La funzione GetIpErrorString può essere usata per recuperare una stringa di errore dell'helper IP per un codice di errore IP. Il codice di errore IP_STATUS passato nel parametro ErrorCode viene restituito nel membro Status del ICMP_ECHO_REPLY, ICMP_ECHO_REPLY32e ICMPV6_ECHO_REPLY strutture usate dalle funzioni ICMP e ICMPv6. Le funzioni che usano queste strutture includono Icmp6ParseReplies, Icmp6SendEcho2, IcmpParseReplies, IcmpSendEcho, IcmpSendEcho2 e IcmpSendEcho2Ex.

La sintassi per la funzione GetIpErrorString è stata leggermente modificata in Microsoft Windows Software Development Kit (SDK) rilasciata per Windows Vista e versioni successive. Il tipo di dati per il parametro Buffer è stato modificato da PWCHAR a PWSTR.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione iphlpapi.h
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche

ICMPV6_ECHO_REPLY

ICMP_ECHO_REPLY

ICMP_ECHO_REPLY32

Informazioni di riferimento sulle funzioni helper IP

Pagina iniziale dell'helper IP

Icmp6ParseReplies

Icmp6SendEcho2

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex