Função DSCreateISecurityInfoObjectEx (dssec.h)

A função DSCreateISecurityInfoObjectEx cria uma instância da interface ISecurityInformation associada ao objeto DS (serviço de diretório) especificado no servidor especificado.

Sintaxe

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parâmetros

[in] pwszObjectPath

O caminho completo do objeto DS para o qual criar uma instância da interface ISecurityInformation .

[in] pwszObjectClass

A classe do objeto especificada pelo parâmetro pwszObjectPath .

[in] pwszServer

O servidor do objeto especificado pelo parâmetro pwszObjectPath . Se o valor desse parâmetro for NULL, o servidor será obtido do caminho especificado pelo parâmetro pwszObjectPath .

[in] pwszUserName

Um nome de usuário a ser associado ao novo objeto ISecurityInformation . Se o valor desse parâmetro for NULL, o padrão ADSI ( Active Directory Services Interfaces ) será usado.

[in] pwszPassword

Uma senha a ser associada ao novo objeto ISecurityInformation . Se o valor desse parâmetro for NULL, o padrão ADSI ( Active Directory Services Interfaces ) será usado.

[in] dwFlags

Sinalizadores usados para a página de propriedades de segurança associada à nova instância da interface ISecurityInformation . Esse parâmetro pode ser 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 de 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] ppSI

Um ponteiro para a instância da interface ISecurityInformation que essa função cria.

[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, DSCreateISecurityInfoObject 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, DSCreateISecurityInfoObject 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 pelos parâmetros pfnReadSD e 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.

Requisitos

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