Função WskRegister (wsk.h)

  • Artigo

A função WskRegister registra um aplicativo WSK, considerando a NPI (Interface de Programação de Rede) do cliente WSK do aplicativo.

Sintaxe

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

Parâmetros

[in] WskClientNpi

Um ponteiro para o NPI do cliente implementado pelo aplicativo WSK.

[out] WskRegistration

Um ponteiro para um local de memória que identifica a instância de registro de um aplicativo WSK. Esse local de memória será inicializado pela chamada WskRegister e será usado pelas outras funções de registro do WSK. O aplicativo WSK nunca deve alterar o conteúdo desse local de memória diretamente.

Retornar valor

WskRegister retorna um dos seguintes códigos NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 O registro foi bem-sucedido.
Outros códigos status
 Falha no registro.

Comentários

Um objeto cliente WSK pode chamar essa função várias vezes, mas um parâmetro WskRegistration diferente deve ser usado para cada chamada para criar várias instâncias de registro.

Para cada chamada para WskRegister que retorna um código de êxito, deve haver exatamente uma chamada WskDeregister correspondente que usa o mesmo parâmetro WskRegistration que foi passado para WskRegister.

O bloco de memória apontado por WskRegistration deve ser mantido alocado (não deve ser liberado ou sair do escopo), desde que haja chamadas pendentes para outras funções de registro do WSK.

Usar as funções WskRegister e WskDeregister é o método preferencial para registrar e cancelar o registro de aplicativos WSK. O Registrador de Módulos de Rede permanece disponível para compatibilidade.

Para obter mais informações sobre como anexar um aplicativo WSK ao subsistema WSK, consulte Registrando um aplicativo kernel Winsock.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho wsk.h (inclua Wsk.h)
Biblioteca Netio.lib
IRQL PASSIVE_LEVEL

Confira também

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister