função ldap_modify_ext (winldap.h)
A função ldap_modify_ext altera uma entrada existente.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
Parâmetros
[in] ld
O identificador de 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 terminada em nulo de modificações a serem feitas na entrada.
[in] ServerControls
Uma lista de controles de servidor LDAP.
[in] ClientControls
Uma lista de controles de cliente
[out] MessageNumber
Esse parâmetro de resultado será definido como a ID da mensagem da solicitação se a chamada for bem-sucedida.
Retornar valor
Se a função for bem-sucedida, o valor retornado será LDAP_SUCCESS.
Se a função falhar, será exibido um código de erro. Consulte Valores retornados para obter mais informações.
Comentários
A função ldap_modify_ext 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.
Os parâmetros e os efeitos de ldap_modify_ext subsume os de ldap_modify. A rotina estendida inclui parâmetros adicionais para dar suporte a controles de cliente e servidor e segurança de thread.
Se tiver êxito, ldap_modify_ext retornará a ID da mensagem para a operação no parâmetro MessageNumber . Chame ldap_result com a ID da mensagem para obter o resultado da operação. Se você preferir que a função retorne o resultado diretamente, use a função estendida síncrona ldap_modify_ext_s.
Multithreading: as chamadas para ldap_modify_ext são thread-safe.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |