Função WskRegister (wsk.h)
A função WskRegister registra um aplicativo WSK, considerando o cliente WSK do aplicativo NPI (Network Programming Interface).
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.
Valor de retorno
WskRegister retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
O registro foi bem-sucedido. |
|
O registro falhou. |
Observações
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. A do 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | wsk.h (inclua Wsk.h) |
| biblioteca | Netio.lib |
| IRQL | PASSIVE_LEVEL |