SO_WSK_SECURITY

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 armazenada em cache do descritor de segurança de um soquete. O descritor de segurança controla o compartilhamento do endereço de transporte local ao qual o soquete está associado.

Essa opção de soquete se aplica somente a soquetes de escuta, soquetes de datagrama e soquetes orientados à conexão.

Se um aplicativo WSK usar essa opção de soquete para aplicar um descritor de segurança a um soquete, ele deverá fazê-lo antes que o soquete seja associado a um endereço de transporte local.

Para aplicar um descritor de segurança a um soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro	Valor
RequestType	WskSetOption
do ControlCode	SO_WSK_SECURITY
de nível de	SOL_SOCKET
InputSize	sizeof(PSECURITY_DESCRIPTOR)
InputBuffer	Um ponteiro para uma variável tipo PSECURITY_DESCRIPTOR. Essa variável deve conter um ponteiro para uma cópia armazenada em cache de um descritor de segurança que foi obtido chamando a funçãoWskControlClient com o código de controle WSK_CACHE_SD.
OutputSize	0
OutputBuffer	ZERO
OutputSizeReturned	ZERO

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 foi aplicado anteriormente ao soquete.

Um aplicativo WSK não deve liberar a cópia armazenada 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 armazenada 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 armazenada em cache do descritor de segurança de um soquete de um soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro	Valor
RequestType	WskGetOption
do ControlCode	SO_WSK_SECURITY
de nível de	SOL_SOCKET
InputSize	0
InputBuffer	ZERO
OutputSize	sizeof(PSECURITY_DESCRIPTOR)
OutputBuffer	Um ponteiro para uma variável tipo PSECURITY_DESCRIPTOR. Essa variável recebe um ponteiro para uma cópia armazenada em cache do descritor de segurança do soquete.
OutputSizeReturned	ZERO

Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para recuperar uma cópia armazenada em cache do descritor de segurança 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 armazenada em cache do descritor de segurança quando ela não for mais necessária.

Consulte a página de referência da estrutura SECURITY_DESCRIPTOR para obter mais informações.

Requisitos

Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Wsk.h (inclua Wsk.h)