ADS_OPTION_ENUM enumeração (iads.h)

Artigo
08/24/2023

O tipo de enumeração ADS_OPTION_ENUM contém valores que indicam as opções que podem ser recuperadas ou definidas com os métodos IADsObjectOptions.GetOption e IADsObjectOptions.SetOption .

Syntax

typedef enum __MIDL___MIDL_itf_ads_0001_0077_0001 {
  ADS_OPTION_SERVERNAME = 0,
  ADS_OPTION_REFERRALS,
  ADS_OPTION_PAGE_SIZE,
  ADS_OPTION_SECURITY_MASK,
  ADS_OPTION_MUTUAL_AUTH_STATUS,
  ADS_OPTION_QUOTA,
  ADS_OPTION_PASSWORD_PORTNUMBER,
  ADS_OPTION_PASSWORD_METHOD,
  ADS_OPTION_ACCUMULATIVE_MODIFICATION,
  ADS_OPTION_SKIP_SID_LOOKUP
} ADS_OPTION_ENUM;

Constantes


`ADS_OPTION_SERVERNAME` Valor: 0 Obtém um VT_BSTR que contém o nome do host do servidor para a associação atual para este objeto . Não há suporte para essa opção no Método IADsObjectOptions.SetOption .
`ADS_OPTION_REFERRALS` Obtém ou define um valor VT_I4 que indica como a busca de referência é executada em um do Banco de Dados Elástico. Essa opção pode conter um dos valores definidos pelo ADS_CHASE_REFERRALS_ENUM Enumeração.
`ADS_OPTION_PAGE_SIZE` Obtém ou define um valor VT_I4 que indica o tamanho da página em uma pesquisa paginada.
`ADS_OPTION_SECURITY_MASK` Obtém ou define um valor VT_I4 que controla os dados do descritor de segurança que podem ser leia sobre o objeto . Essa opção pode conter qualquer combinação dos valores definidos no ADS_SECURITY_INFO_ENUM enumeração.
`ADS_OPTION_MUTUAL_AUTH_STATUS` Obtém um valor VT_I4 que determina se a autenticação mútua é executada pelo Camada SSPI. Se o valor da opção retornada contiver o sinalizador ISC_RET_MUTUAL_AUTH , definido em Sspi.h e, em seguida, a autenticação mútua foi executada. Se o valor da opção retornado não contiver o sinalizador ISC_RET_MUTUAL_AUTH e, em seguida, a autenticação mútua não foi executada. For (para) para obter mais informações sobre autenticação mútua, consulte SSPI. Esse não há suporte para a opção Método IADsObjectOptions.SetOption .
`ADS_OPTION_QUOTA` Permite que a cota efetiva e a cota usada de uma entidade de segurança sejam lidas. Essa opção usa um VT_BSTR valor que contém a entidade de segurança para a qual as cotas podem ser lidas. Se a cadeia de caracteres da entidade de segurança tiver comprimento zero ou o valor for um valor VT_EMPTY , a entidade de segurança é o usuário conectado no momento. Essa opção só tem suporte do Método IADsObjectOptions.SetOption .
`ADS_OPTION_PASSWORD_PORTNUMBER` Recupera ou define um valor VT_I4 que contém o número da porta que ADSI usa para estabelecer uma conexão quando a senha for definida ou alterada. Por padrão, o ADSI usa a porta 636 para estabelecer um para definir ou alterar a senha.
`ADS_OPTION_PASSWORD_METHOD` Recupera ou define um valor VT_I4 que especifica o método de codificação de senha. Essa opção pode conter um dos valores definidos no ADS_PASSWORD_ENCODING_ENUM Enumeração.
`ADS_OPTION_ACCUMULATIVE_MODIFICATION` Contém um valor VT_BOOL que especifica se operações de alteração de valor de atributo deve ser acumulado. Por padrão, quando um valor de atributo é modificado mais de uma vez, o valor anterior A operação de alteração é substituída pela operação mais recente. Se essa opção estiver definida como VARIANT_TRUE, cada operação de alteração de valor de atributo é acumulada no cache. Quando as atualizações de valor de atributo são confirmadas no servidor com o Método IADs.SetInfo , cada indivíduo acumulado A operação é enviada para o servidor. Quando essa opção tiver sido definida como VARIANT_TRUE, ela não poderá ser redefinida para VARIANT_FALSE durante o tempo de vida do objeto ADSI. Para redefinir essa opção, todos as referências ao objeto ADSI devem ser liberadas e o objeto deve ser associado novamente. Quando o objeto está associado para novamente, essa opção será definida como VARIANT_FALSE por padrão. Essa opção afeta apenas os valores de atributo modificados com o IADs.PutEx e IADsPropertyList.PutPropertyItem Métodos. Essa opção é ignorada pelo método IADs.Put .
`ADS_OPTION_SKIP_SID_LOOKUP` Se essa opção estiver definida no objeto , nenhuma pesquisa será executada (durante a recuperação ou durante modificação). Essa opção afeta as IADs e Interfaces IADsPropertyList . Também é aplicável ao recuperar o uso efetivo da cota de um usuário específico.