Compartilhar via


estrutura WSK_INSPECT_ID (wsk.h)

A estrutura WSK_INSPECT_ID especifica um identificador para uma solicitação de conexão de entrada em um soquete de escuta.

Sintaxe

typedef struct _WSK_INSPECT_ID {
  ULONG_PTR Key;
  ULONG     SerialNumber;
} WSK_INSPECT_ID, *PWSK_INSPECT_ID;

Membros

Key

Uma chave atribuída à solicitação de conexão de entrada.

SerialNumber

Um número de série atribuído à solicitação de conexão de entrada.

Comentários

O subsistema WSK passa um ponteiro para uma estrutura WSK_INSPECT_ID para a função de retorno de chamada de evento WskInspectEvent de um aplicativo WSK sempre que uma solicitação de conexão de entrada chega em um soquete de escuta que tem o modo de aceitação condicional habilitado. O conteúdo da estrutura WSK_INSPECT_ID identifica exclusivamente a solicitação de conexão de entrada.

Se o aplicativo WSK retornar WskInspectPend de uma chamada para sua função de retorno de chamada de evento WskInspectEvent , o aplicativo deverá primeiro copiar o conteúdo da estrutura WSK_INSPECT_ID fornecida pelo subsistema WSK em sua própria estrutura WSK_INSPECT_ID. Em seguida, o aplicativo WSK passa um ponteiro para sua estrutura WSK_INSPECT_ID para a função WskInspectComplete quando conclui a inspeção.

Se a solicitação de conexão de entrada for descartada pelo sistema remoto enquanto uma operação de inspeção estiver pendente, o subsistema WSK chamará a função de retorno de chamada de evento WskAbortEvent do aplicativo WSK com um ponteiro para uma estrutura WSK_INSPECT_ID que identifica a solicitação descartada. O aplicativo WSK usa o conteúdo dessa estrutura WSK_INSPECT_ID para determinar qual inspeção de uma solicitação de conexão de entrada deve ser encerrada. O aplicativo WSK deve comparar o conteúdo das estruturas de WSK_INSPECT_ID com marcar para uma correspondência. Os valores reais dos membros da estrutura são irrelevantes.

Um aplicativo WSK pode habilitar o modo de aceitação condicional em um soquete de escuta habilitando a opção de soquete SO_CONDITIONAL_ACCEPT . Para obter mais informações sobre como aceitar condicionalmente conexões de entrada, consulte Escutando e aceitando Connections de entrada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho wsk.h (inclua Wsk.h)

Confira também

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent