Partilhar 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.

Observações

O subsistema WSK passa um ponteiro para uma estrutura de WSK_INSPECT_ID para o WskInspectEvent de um aplicativo WSK função de retorno de chamada de evento 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 de WSK_INSPECT_ID. Em seguida, o aplicativo WSK passa um ponteiro para sua estrutura de WSK_INSPECT_ID para a função WskInspectComplete quando concluir 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á o WskAbortEvent do aplicativo WSK função de retorno de chamada de evento com um ponteiro para uma estrutura de 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 para verificar se há 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 conexões de entrada.

Requisitos

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

Consulte também

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent