PFN_WSK_BIND funzione di callback (wsk.h)

Articolo
02/07/2025

La funzione WskBind associa un socket a un indirizzo di trasporto locale.

Sintassi

PFN_WSK_BIND PfnWskBind;

NTSTATUS PfnWskBind(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR LocalAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

Parametri

[in] Socket

Puntatore a una struttura WSK_SOCKET che specifica l'oggetto socket per il socket associato.

[in] LocalAddress

Puntatore a una struttura che specifica l'indirizzo di trasporto locale a cui associare il socket. Questo puntatore deve essere un puntatore al tipo di struttura SOCKADDR specifico che corrisponde alla famiglia di indirizzi specificata dall'applicazione WSK al momento della creazione del socket.

Flags

Questo parametro è riservato per l'uso del sistema. Un'applicazione WSK deve impostare questo parametro su zero.

[in, out] Irp

Puntatore a un IRP allocato dal chiamante usato dal sottosistema WSK per completare l'operazione di associazione in modo asincrono. Per altre informazioni sull'uso di runtime di integrazione con funzioni WSK, vedere Uso di runtime di integrazione con Funzioni kernel Winsock.

Valore restituito

WskBind restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il socket è stato associato correttamente all'indirizzo di trasporto locale. L'IRP verrà completato con lo stato di esito positivo.
STATUS_PENDING	Il sottosistema WSK non è riuscito ad associare immediatamente il socket. Il sottosistema WSK completerà l'IRP dopo aver associato il socket all'indirizzo di trasporto locale. Lo stato dell'operazione di associazione verrà restituito nel campo IoStatus.Status di IRP.
STATUS_FILE_FORCED_CLOSED	Il socket non è più funzionale. L'IRP verrà completato con lo stato di errore. L'applicazione WSK deve chiamare la funzione WskCloseSocket per chiudere il socket il prima possibile.
Altri codici di stato	Si è verificato un errore. L'IRP verrà completato con lo stato di errore.

Osservazioni

Per un socket di ascolto, chiamando la funzione WskBind prepara il socket per l'ascolto delle richieste di connessione in ingresso sull'indirizzo di trasporto locale specificato. Se un'applicazione WSK specifica un indirizzo con caratteri jolly locali, il socket sarà in ascolto delle richieste di connessione in ingresso su tutti gli indirizzi di trasporto locali.

Per un socket di datagrammi, chiamando la funzione WskBind prepara il socket per l'invio e la ricezione di datagrammi nell'indirizzo di trasporto locale specificato. Se un'applicazione WSK specifica un indirizzo con caratteri jolly locali, il socket riceverà i datagrammi su tutti gli indirizzi di trasporto locali e invierà datagrammi dall'indirizzo di trasporto locale appropriato determinato dalle informazioni di routing del sistema.

Per un socket orientato alla connessione, la chiamata alla funzione WskBind associa il socket all'indirizzo di trasporto locale specificato. WskBind deve essere chiamato prima di chiamare la funzione WskConnect. Se un'applicazione WSK specifica un indirizzo con caratteri jolly locali, lo stack di rete associa il socket all'indirizzo di trasporto locale appropriato quando l'applicazione chiama WskConnect per connettere il socket a un indirizzo di trasporto remoto. In tale situazione, l'indirizzo di trasporto locale è determinato dalle informazioni di routing del sistema.

Per un socket di flusso, la chiamata alla funzione WskBind associa il socket all'indirizzo di trasporto locale specificato. Se un'applicazione WSK specifica un indirizzo con caratteri jolly locali, lo stack di rete associa il socket a un indirizzo di trasporto locale disponibile. WskBind deve essere chiamato prima di chiamare il WskListen o le funzioni di WskConnect.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Universale
intestazione	wsk.h (include Wsk.h)
IRQL	<= DISPATCH_LEVEL