Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A opção de soquete SO_WSK_SECURITY permite que um aplicativo WSK aplique um descritor de segurança a um soquete ou recupere uma cópia em cache do descritor de segurança de um soquete de um soquete. O descritor de segurança controla o compartilhamento do endereço de transporte local ao qual o soquete está vinculado.
Essa opção de soquete se aplica somente a soquetes de escuta, soquetes de datagrama e soquetes orientados a conexão.
Se um aplicativo WSK usa essa opção de soquete para aplicar um descritor de segurança a um soquete, ele deve fazê-lo antes que o soquete seja vinculado a um endereço de transporte local.
Para aplicar um descritor de segurança a um soquete, um aplicativo WSK chama o função WskControlSocket com os seguintes parâmetros.
| Parâmetro | Valor |
|---|---|
RequestType |
WskSetOption |
ControlCode |
SO_WSK_SECURITY |
Nível |
SOL_SOCKET |
InputSize |
tamanho de(PSECURITY_DESCRIPTOR) |
InputBuffer |
Um ponteiro para uma variável PSECURITY_DESCRIPTOR-typed. Essa variável deve conter um ponteiro para uma cópia em cache de um descritor de segurança que foi obtido chamando a função WskControlClient com o código de controle WSK_CACHE_SD. |
OutputSize |
0 |
OutputBuffer |
NULO |
OutputSizeReturned |
NULO |
Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para aplicar um descritor de segurança a um soquete.
Se um aplicativo WSK usar essa opção de soquete para aplicar um descritor de segurança a um soquete, o novo descritor de segurança substituirá qualquer descritor de segurança que tenha sido aplicado anteriormente ao soquete.
Um aplicativo WSK não deve liberar a cópia em cache do descritor de segurança até que o IRP seja concluído.
Um aplicativo WSK também pode aplicar um descritor de segurança a um soquete quando o soquete é criado inicialmente, especificando um ponteiro para uma cópia em cache de um descritor de segurança no parâmetro SecurityDescriptor quando ele chama o WskSocket ou função WskSocketConnect.
Se um aplicativo WSK não aplicar um descritor de segurança a um soquete, o subsistema WSK usará um descritor de segurança padrão que não permite o compartilhamento do endereço de transporte local.
Para recuperar uma cópia em cache do descritor de segurança de um soquete de um soquete, um aplicativo WSK chama o função WskControlSocket com os seguintes parâmetros.
| Parâmetro | Valor |
|---|---|
RequestType |
WskGetOption |
ControlCode |
SO_WSK_SECURITY |
Nível |
SOL_SOCKET |
InputSize |
0 |
InputBuffer |
NULO |
OutputSize |
tamanho de(PSECURITY_DESCRIPTOR) |
OutputBuffer |
Um ponteiro para uma variável PSECURITY_DESCRIPTOR-typed. Essa variável recebe um ponteiro para uma cópia em cache do descritor de segurança do soquete. |
OutputSizeReturned |
NULO |
Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função de WskControlSocket para recuperar uma cópia em cache do descritor de segurança de um soquete de um soquete.
Um aplicativo WSK deve chamar a função WskControlClient com o código de controle WSK_RELEASE_SD para liberar a cópia em cache do descritor de segurança quando ela não for mais necessária.
Consulte a página de referência para a estrutura SECURITY_DESCRIPTOR para obter mais informações.
Requerimentos
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Wsk.h (inclui Wsk.h) |