Funzione WSAStringToAddressA (winsock2.h)

Articolo
11/20/2024

La funzione WSAStringToAddress converte un indirizzo di rete nel formato di presentazione testo standard nel formato binario numerico in una struttura sockaddr, adatta per il passaggio 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 che contiene l'indirizzo di rete in formato 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 utilizzare. Se si tratta di null, la chiamata viene instradata al provider del primo protocollo che supporta il AddressFamily indicato.

[out] lpAddress

Puntatore a un buffer riempito con un sockaddr struttura 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 di funzione ha esito positivo, questo parametro restituisce un puntatore alla dimensione del sockaddr struttura restituita nel parametro lpAddress. Se il buffer specificato non è sufficiente, la funzione non riesce con un errore specifico di WSAEFAULT e questo parametro viene aggiornato con le dimensioni richieste in byte.

Valore restituito

Il valore restituito per WSAStringToAddress è zero se l'operazione ha avuto esito positivo. In caso contrario, viene restituito il valore SOCKET_ERROR 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 sono riuscite a convertire la stringa in un sockaddr. Per altre informazioni, vedere la sezione Osservazioni seguenti.
WSANOTINITIALISED	Il WS2_32.DLL non è stato inizializzato. L'applicazione deve prima chiamare WSAStartup prima di chiamare qualsiasi funzione Di Windows Socket.
WSA_NOT_ENOUGH_MEMORY	Memoria insufficiente per eseguire l'operazione.

Osservazioni

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

Per impostazione predefinita, eventuali componenti mancanti dell'indirizzo verranno considerati un valore ragionevole, se possibile. Ad esempio, un numero di porta mancante verrà impostato su zero. Se il chiamante desidera che la traduzione venga eseguita da un provider specifico, deve fornire la struttura 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 è stata aggiunta 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 di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
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	Finestre
intestazione	winsock2.h
libreria	Ws2_32.lib
dll	Ws2_32.dll