Função ldap_add (winldap.h)

Artigo
03/08/2023

A função ldap_add inicia uma operação de adição assíncrona a uma árvore de diretório. Para que uma operação de adição tenha êxito, o pai da entrada adicionada deve existir ou o pai deve estar vazio (igual ao nome diferenciado da raiz).

Sintaxe

WINLDAPAPI ULONG LDAPAPI ldap_add(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

Parâmetros

[in] ld

O identificador da sessão.

[in] dn

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome diferenciado da entrada a ser adicionada.

[in] attrs

Uma matriz de ponteiros para estruturas LDAPMod . Cada estrutura especifica um único atributo.

Valor retornado

Se a função for bem-sucedida, a ID da mensagem da operação de adição será retornada.

Se a função falhar, ela retornará –1 e definirá os parâmetros de erro de sessão na estrutura de dados LDAP . Para recuperar os dados de erro, use LdapGetLastError.

Comentários

Antes de chamar ldap_add, crie uma entrada especificando seus atributos em estruturas LDAPMod . Defina o membro mod_op de cada estrutura como LDAP_MOD_ADD e defina os membros mod_type e mod_vals conforme apropriado para sua entrada.

Como uma função assíncrona, ldap_add retorna uma ID de mensagem para a operação. Chame ldap_result com a ID da mensagem para obter o resultado da operação. Para cancelar uma operação de adição assíncrona antes de ser concluída, chame ldap_abandon.

Para que os resultados sejam retornados diretamente, use a função síncrona ldap_add_s. Use ldap_add_ext ou ldap_add_ext_s para habilitar o suporte para controles de servidor e cliente LDAP 3.

Multithreading: as chamadas para ldap_add são thread-safe, desde que LdapGetLastError seja usado para recuperar o código de erro de sessão real quando a chamada de função retornar o código de falha -1.

Nota Ao se conectar a um servidor LDAP 2, o aplicativo deve executar uma operação de associação chamando uma das rotinas de ldap_bind ou ldap_simple_bind antes de tentar outras operações.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	winldap.h
Biblioteca	Wldap32.lib
DLL	Wldap32.dll