Compartilhar via


Função SeValidSecurityDescriptor (wdm.h)

A rotina SeValidSecurityDescriptor retorna se um descritor de segurança determinado é estruturalmente válido.

Sintaxe

BOOLEAN SeValidSecurityDescriptor(
  [in] ULONG                Length,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parâmetros

[in] Length

Especifica o tamanho em bytes do descritor de segurança especificado.

[in] SecurityDescriptor

Ponteiro para o SECURITY_DESCRIPTOR auto-relativo, que deve ser armazenado em buffer em algum lugar no espaço do sistema.

Retornar valor

SeValidSecurityDescriptorretornará TRUE se o descritor de segurança em buffer for estruturalmente válido.

Comentários

SeValidSecurityDescriptor não impõe a política. Ele simplesmente verifica se os dados do descritor de segurança especificados estão formatados corretamente. Em particular, ele verifica as informações de revisão, a autolatividade, o proprietário, o alinhamento e, se disponíveis, SID, grupo, DACL, ACL e/ou SACL não excedem o Comprimento fornecido. Consequentemente, os chamadores de SeValidSecurityDescriptor não podem assumir que um TRUE retornado implica que o descritor de segurança especificado necessariamente tem conteúdo válido.

Se SeValidSecurityDescriptor retornar TRUE, o descritor de segurança especificado poderá ser passado para outro componente do modo kernel porque ele é estruturalmente válido. Caso contrário, passar um descritor de segurança estruturalmente inválido para ser manipulado por outro componente do modo kernel pode causar resultados indefinidos ou até mesmo um bug do sistema marcar.

Para validar um descritor de segurança que foi passado do modo de usuário, chame RtlValidSecurityDescriptor em vez de SeValidSecurityDescriptor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR