Função DSCreateSecurityPage (dssec.h)

  • Artigo

A função DSCreateSecurityPage cria uma página de propriedades de segurança para um objeto do Active Directory. A página de propriedades resultante pode ser adicionada a uma folha de propriedades.

Sintaxe

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parâmetros

[in] pwszObjectPath

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que representa o caminho completo do Active Directory para o objeto.

[in, optional] pwszObjectClass

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que representa a classe de objeto. Esse valor pode ser NULL.

[in] dwFlags

Sinalizadores usados para a página de propriedades de segurança. Esse parâmetro pode ser nenhum ou qualquer combinação dos sinalizadores a seguir.

Valor Significado
DSSI_READ_ONLY
0x00000001
 As propriedades de segurança são somente leitura.
DSSI_NO_ACCESS_CHECK
0x00000002
 Nenhuma marcar de acesso é executada.
DSSI_NO_EDIT_SACL
0x00000004
 A propriedade SACL ( lista de controle de acesso do sistema ) é somente leitura.
DSSI_NO_EDIT_OWNER
0x00000008
 A propriedade do proprietário do objeto é somente leitura.
DSSI_IS_ROOT
0x00000010
 O objeto é um objeto raiz.
DSSI_NO_FILTER
0x00000020
 Não aplique nenhum filtro.
DSSI_NO_READONLY_MESSAGE
0x00000040
 Suprimir mensagens pop-up somente leitura.

[out] phPage

Um ponteiro para um HPROPSHEETPAGE que retorna a página de propriedades de segurança criada.

[in, optional] pfnReadSD

Um ponteiro para uma função usada para ler o descritor de segurança do objeto. Esse valor pode ser NULL. Se pfnReadSD não for NULL, DSCreateSecurityPage chamará a função referenciada por pfnReadSD para recuperar o descritor de segurança do objeto.

[in, optional] pfnWriteSD

Um ponteiro para uma função usada para gravar o descritor de segurança do objeto. Esse valor pode ser NULL. Se pfnWriteSD não for NULL, DSCreateSecurityPage chamará a função referenciada por pfnWriteSD para gravar o descritor de segurança do objeto.

[in] lpContext

Contexto a ser passado para as funções identificadas por pfnReadSD ou pfnWriteSD.

Valor retornado

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

A função apontada por pfnReadSD é definida da seguinte maneira.

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

A função DSCreateSecurityPage liberará o descritor de segurança retornado no terceiro parâmetro acima por uma chamada para a função LocalFree .

A função apontada por pfnWriteSD é definida da seguinte maneira.

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dssec.h
Biblioteca DSSec.lib
DLL DSSec.dll

Confira também

Página de propriedades de segurança básica

ISecurityInformation