função ldap_modify_ext_s (winldap.h)

Artigo
03/13/2024

A função ldap_modify_ext_s altera uma entrada existente.

Sintaxe

WINLDAPAPI ULONG LDAPAPI ldap_modify_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] mods,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

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.

[in] ServerControls

Uma lista de controles de servidor LDAP.

[in] ClientControls

Uma lista de controles de cliente.

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_s inicia uma operação sí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 efeitos de ldap_modify_ext_s subsume os de ldap_modify_s. A rotina estendida inclui parâmetros adicionais para dar suporte a controles de cliente e servidor.

Multithreading: as chamadas para ldap_modify_ext_s 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