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) |