Função DSCreateSecurityPage (dssec.h)
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 |
|---|---|
|
As propriedades de segurança são somente leitura. |
|
Nenhuma marcar de acesso é executada. |
|
A propriedade SACL ( lista de controle de acesso do sistema ) é somente leitura. |
|
A propriedade do proprietário do objeto é somente leitura. |
|
O objeto é um objeto raiz. |
|
Não aplique nenhum filtro. |
|
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 |