Funzione WSAStringToAddressA (winsock2.h)

Articolo
03/08/2023

La funzione WSAStringToAddress converte un indirizzo di rete nel formato di presentazione di testo standard nella sua forma binaria numerica in una struttura sockaddr , adatta per passare alle routine di Windows Sockets che accettano tale struttura.

Sintassi

INT WSAAPI WSAStringToAddressA(
  [in]           LPSTR               AddressString,
  [in]           INT                 AddressFamily,
  [in, optional] LPWSAPROTOCOL_INFOA lpProtocolInfo,
  [out]          LPSOCKADDR          lpAddress,
  [in, out]      LPINT               lpAddressLength
);

Parametri

[in] AddressString

Puntatore alla stringa con terminazione zero contenente l'indirizzo di rete nel formato di testo standard da convertire.

[in] AddressFamily

Famiglia di indirizzi dell'indirizzo di rete a cui punta il parametro AddressString .

[in, optional] lpProtocolInfo

Struttura WSAPROTOCOL_INFO associata al provider da usare. Se si tratta di NULL, la chiamata viene instradata al provider del primo protocollo che supporta l'indirizzo AddressFamily indicato.

[out] lpAddress

Puntatore a un buffer riempito con una struttura sockaddr per la stringa di indirizzo se la funzione ha esito positivo.

[in, out] lpAddressLength

Puntatore alla lunghezza, in byte, del buffer a cui punta il parametro lpAddress . Se la chiamata alla funzione ha esito positivo, questo parametro restituisce un puntatore alle dimensioni della struttura sockaddr restituita nel parametro lpAddress . Se il buffer specificato non è sufficiente, la funzione ha esito negativo con un errore specifico di WSAEFAULT e questo parametro viene aggiornato con le dimensioni necessarie in byte.

Valore restituito

Il valore restituito per WSAStringToAddress è zero se l'operazione ha avuto esito positivo. In caso contrario, il valore SOCKET_ERROR viene restituito e un numero di errore specifico può essere recuperato chiamando WSAGetLastError.

Codice di errore	Significato
WSAEFAULT	Il buffer a cui punta il parametro lpAddress è troppo piccolo. Passare un buffer più grande.
WSAEINVAL	Le funzioni non erano in grado di tradurre la stringa in un sockaddr. Per altre informazioni, vedere la sezione Osservazioni seguenti.
WSANOTINITIALISED	La WS2_32.DLL non è stata inizializzata. L'applicazione deve prima chiamare WSAStartup prima di chiamare tutte le funzioni di Windows Socket.
WSA_NOT_ENOUGH_MEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

La funzione WSAStringToAddress converte un indirizzo di rete nel formato di testo standard nella sua forma binaria numerica in una struttura sockaddr .

Eventuali componenti mancanti dell'indirizzo verranno predefiniti a un valore ragionevole, se possibile. Ad esempio, un numero di porta mancante verrà predefinito su zero. Se il chiamante vuole che la traduzione venga eseguita da un determinato provider, deve fornire la struttura di WSAPROTOCOL_INFO corrispondente nel parametro lpProtocolInfo .

La funzione WSAStringToAddress ha esito negativo (e restituisce WSAEINVAL) se il membro sin_family della struttura SOCKADDR_IN, passato nel parametro lpAddress sotto forma di struttura sockaddr, non è impostato su AF_INET o AF_INET6.

Il supporto per gli indirizzi IPv6 tramite la funzione WSAStringToAddress è stato aggiunto in Windows XP con Service Pack 1 (SP1) e versioni successive. IPv6 deve essere installato anche nel computer locale per la funzione WSAStringToAddress per supportare gli indirizzi IPv6.

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Nota

L'intestazione winsock2.h definisce WSAStringToAddress come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 8.1, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winsock2.h
Libreria	Ws2_32.lib
DLL	Ws2_32.dll