Estrutura LDAPModA (winldap.h)

Artigo
11/20/2024

A estrutura de LDAPMod contém os dados necessários para executar uma operação de modificação.

Sintaxe

typedef struct ldapmodA {
  ULONG mod_op;
  PCHAR mod_type;
  union {
    PCHAR  *modv_strvals;
    berval **modv_bvals;
  } mod_vals;
} LDAPModA, *PLDAPModA;

Membros

mod_op

Especifica um dos valores a seguir para indicar a operação de modificação a ser executada.

Você pode usar o operador or de bit a bit para combinar o valor da operação com LDAP_MOD_BVALUES para indicar que o mod_vals união usa o membro modv_bvals. Se LDAP_MOD_BVALUES não estiver definido, o sindicato usará o membro modv_strvals.

LDAP_MOD_ADD (0x00)

Adiciona um valor à entrada. Os valores fornecidos são acrescentados aos valores existentes no atributo.

LDAP_MOD_DELETE (0x01)

Exclui um valor na entrada. Os valores fornecidos são excluídos dos valores de atributo atuais.

LDAP_MOD_REPLACE (0x02)

Substitui um valor na entrada. Os valores fornecidos substituem os valores de atributo existentes.

mod_type

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do atributo a ser modificado.

mod_vals

Ponteiro para uma matriz de valores, se houver, para adicionar, excluir ou substituir. Se mop_op não incluir o sinalizador de LDAP_MOD_BVALUES, o membro modv_strvals será um ponteiro para uma matriz de cadeias de caracteres terminadas em nulo. Se mop_op incluir LDAP_MOD_BVALUES, o membro modv_bvals será um ponteiro para uma matriz de ponteiros berval, o que é útil para especificar valores binários.

mod_vals.modv_strvals

Ponteiro para uma matriz terminada em nulo de cadeias de caracteres terminadas em nulo. O último elemento da matriz deve ser um ponteiro de NULL .

mod_vals.modv_bvals

Ponteiro para uma matriz NULLterminada de ponteiros berval. O último elemento da matriz deve ser um ponteiro de NULL .

Observações

Atribua valores aos campos da estrutura de LDAPMod antes de chamar uma função de modificação (* ldap_add* ou ldap_modify*).

ldap_modify* com a operação LDAP_MOD_REPLACE não exclui um atributo quando passado um ponteiro nulo. No entanto, LDAP_MOD_DELETE exclui todo o atributo quando mod_vals é definido como NULL.

Ao passar uma estrutura LDAPMod para as funções de ldap_add*, somente o sinalizador LDAP_MOD_BVALUES é significativo. A criação de um novo objeto implica na adição de valores a ele.

Nota

O cabeçalho winldap.h define LDAPMod como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.