Compartilhar via


Função ldap_modify (winldap.h)

A função ldap_modify altera uma entrada existente.

Sintaxe

WINLDAPAPI ULONG LDAPAPI ldap_modify(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

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 da entrada a ser modificada.

[in] mods

Uma matriz de modificações terminada em nulo a ser feita na entrada.

Valor retornado

Se a função for bem-sucedida, ela retornará a ID da mensagem da operação de modificação.

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

Comentários

A função ldap_modify inicia uma operação assíncrona para modificar uma entrada existente. Se os valores estiverem sendo adicionados ou substituídos na entrada, a função criará o atributo, se necessário. Se os valores estiverem sendo excluídos e nenhum valor permanecer, a função removerá o atributo . Todas as modificações são executadas na ordem em que estão listadas.

Como uma função assíncrona, ldap_modify 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 assíncrona antes de ser concluída, chame ldap_abandon.

Se você preferir que a função retorne os resultados diretamente, use a rotina síncrona ldap_modify_s. Use ldap_modify_ext ou ldap_modify_ext_s se precisar de suporte para controles de servidor e cliente LDAP 3.

Multithreading: as chamadas para ldap_modify 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 qualquer outra operação.
 

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

Confira também

Funções

LDAP

Ldapmod

Modificando uma entrada de diretório

Ldap_abandon

Ldap_bind

ldap_modify_ext

ldap_modify_ext_s

ldap_modify_s

Ldap_result

ldap_simple_bind