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.

[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