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.
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 |