Funzione di callback LPWSPSOCKET (ws2spi.h)

La funzione LPWSPSocket crea un socket. Per informazioni sulla parte eseguita da LPWSPSocket nella creazione di un socket condiviso, vedere Socket condivisi e socket condivisi in SPI.

Sintassi

LPWSPSOCKET Lpwspsocket;

SOCKET Lpwspsocket(
  [in]  int af,
  [in]  int type,
  [in]  int protocol,
  [in]  LPWSAPROTOCOL_INFOW lpProtocolInfo,
  [in]  GROUP g,
        DWORD dwFlags,
  [out] LPINT lpErrno
)
{...}

Parametri

[in] af

Specifica della famiglia di indirizzi.

[in] type

Specifica del tipo per il nuovo socket.

[in] protocol

Protocollo da usare con il socket specifico della famiglia di indirizzi indicata.

[in] lpProtocolInfo

Puntatore a una struttura WSAProtocol_Info che definisce le caratteristiche del socket da creare.

[in] g

Riservato.

dwFlags

Specifica dell'attributo Socket.

[out] lpErrno

Puntatore al codice di errore.

Valore restituito

Se non si verifica alcun errore, LPWSPSocket restituisce un descrittore che fa riferimento al nuovo socket. In caso contrario, viene restituito un valore di INVALID_SOCKET e un codice di errore specifico è disponibile in lpErrno.

Commenti

La funzione LPWSPSocket causa l'allocazione di un descrittore socket e di qualsiasi risorsa correlata. Per impostazione predefinita, il socket creato non avrà l'attributo sovrapposto. I provider di Windows Sockets sono invitati a essere realizzati come file system installabili da Windows e gli handle dei file di sistema vengono forniti come descrittori socket. Questi provider devono chiamare WPUModifyIFSHandle prima di restituire da questa funzione. Per i provider Windows Sockets non file system, WPUCreateSocketHandle deve essere usato per acquisire un descrittore socket univoco dal Ws2_32.dll prima di restituire da questa funzione. Vedere
Allocazione del descrittore per altre informazioni.

I valori per af, tipo e protocollo sono quelli forniti dall'applicazione nel socket delle funzioni API corrispondente o WSASocket. Un provider di servizi è libero di ignorare o prestare attenzione a qualsiasi o a tutti questi valori, come è appropriato per il protocollo specifico. Tuttavia, il provider deve essere disposto ad accettare il valore di zero per af e tipo, poiché il Ws2_32.dll considera che questi valori siano jolly. Inoltre, il valore della costante manifesto FROM_PROTOCOL_INFO deve essere accettato per uno qualsiasi di af, tipo e protocollo. Questo valore indica che l'applicazione Windows Sockets 2 deve usare i valori corrispondenti dalla struttura WSAProtocol_Info (iAddressFamily, iSocketType, iProtocol).

Il parametro dwFlags può essere usato per specificare gli attributi del socket usando l'operatore OR bit per bit con uno dei flag seguenti.

I socket orientati alla connessione, ad esempio SOCK_STREAM forniscono connessioni full-duplex, e devono trovarsi in uno stato connesso prima che tutti i dati possano essere inviati o ricevuti su di essi. Viene creata una connessione a un altro socket con una chiamata LPWSPConnect . Una volta connessi, i dati possono essere trasferiti usando chiamate LPWSPSend e LPWSPRecv . Al termine di una sessione, è necessario eseguire un LPWSPCloseSocket .

I protocolli di comunicazione usati per implementare un socket affidabile e orientato alla connessione garantiscono che i dati non vengano persi o duplicati. Se i dati per cui il protocollo peer dispone di spazio buffer non possono essere trasmessi correttamente entro un periodo di tempo ragionevole, la connessione viene considerata interrotta e le chiamate successive avranno esito negativo con il codice di errore impostato su WSAETIMEDOUT.

I socket senza connessione e orientati ai messaggi consentono l'invio e la ricezione di datagrammi da e verso peer arbitrari usando LPWSPSendTo e LPWSPRecvFrom. Se tale socket è connesso tramite LPWSPConnect a un peer specifico, i datagrammi possono essere inviati al peer usando LPWSPSend e possono essere ricevuti solo da questo peer usando LPWSPRecv.

Il supporto per i socket con tipo SOCK RAW non è obbligatorio, ma i provider di servizi sono invitati a supportare socket non elaborati ogni volta che è opportuno farlo.

Un provider di servizi a livelli fornisce un'implementazione di questa funzione, ma è anche un client di questa funzione se e quando chiama LPWSPSocket del livello successivo nella catena di protocolli. Alcune considerazioni speciali si applicano al parametro lpProtocolInfo della funzione perché viene propagato verso il basso attraverso i livelli della catena di protocolli.

Se il livello successivo della catena di protocolli è un altro livello, quando viene chiamato LPWSPSocket del livello successivo, questo livello deve passare al livello successivo un lpProtocolInfo che fa riferimento alla stessa struttura non modificata WSAProtocol_Info con le stesse informazioni sulla catena non modificata. Tuttavia, se il livello successivo è il protocollo di base , ovvero l'ultimo elemento della catena, questo livello esegue una sostituzione quando si chiama LPWSPSocket del provider di base. In questo caso, la struttura di WSAPROTOCOL_INFO del provider di base deve essere a cui fa riferimento il parametro lpProtocolInfo .

Un vantaggio fondamentale di questa politica è che i provider di servizi di base non devono essere consapevoli delle catene di protocolli.

Questo stesso criterio di propagazione si applica quando si propaga una struttura WSAProtocol_Info tramite una sequenza di altre funzioni, ad esempio LPWSPAddressToString, LPWSPDuplicateSocket, WSPStartup o LPWSPStringToAddress.

Requisiti

Vedi anche

• WPUCreateSocketHandle
• LPWSPAccept
• LPWSPBind
• LPWSPConnect
• LPWSPCloseSocket
• LPWSPGetSockName
• LPWSPGetSockOpt
• LPWSPIoctl
• LPWSPListen
• LPWSPRecv
• LPWSPRecvFrom
• LPWSPSend
• LPWSPSendTo
• LPWSPSetSockOpt
• LPWSPShutdown