PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST funzione di callback (wsk.h)
La funzione WskRelease rilascia un elenco collegato di strutture WSK_DATAGRAM_INDICATION mantenute in precedenza da un'applicazione WSK.
WskRelease può essere dichiarato in due modi diversi, a seconda del tipo di socket. Questo argomento descrive WskRelease per i socket di datagram. Per i socket di connessione o in ascolto, vedere WskRelease (socket di ascolto o orientata alla connessione).
Sintassi
PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;
NTSTATUS PfnWskReleaseDatagramIndicationList(
[in] PWSK_SOCKET Socket,
[in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}
Parametri
[in] Socket
Puntatore a una struttura WSK_SOCKET che specifica l'oggetto socket per il socket da cui sono stati ricevuti i dati.
[in] DatagramIndication
Puntatore all'elenco collegato di strutture da rilasciare. Per questo parametro, l'applicazione WSK deve specificare il parametro DatagramIndication passato al relativo callback dell'evento WskReceiveEvent o WskReceiveFromEvent.
Valore restituito
WskRelease restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
L'elenco delle strutture è stato rilasciato correttamente. |
|
È stato specificato un parametro non valido. |
Commenti
Un'applicazione WSK chiama la funzione WskRelease per rilasciare un elenco collegato di strutture WSK_DATAGRAM_INDICATION mantenute in precedenza restituendo STATUS_PENDING dal relativo WskReceiveEvent o dalla relativa funzione di callback dell'evento WskReceiveFromEvent .
La chiusura di un socket chiamando la funzione WskCloseSocket non rilascia elenchi collegati conservati in sospeso di strutture. Un'applicazione WSK deve rilasciare tutti gli elenchi collegati conservati di strutture prima che l'applicazione chiami la funzione WskCloseSocket per chiudere il socket.
Requisiti
| 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 |