função ldap_modify_s (winldap.h)

Artigo
03/13/2024

A função ldap_modify_s altera uma entrada existente.

Sintaxe

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

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.

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_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, a função removerá o atributo se nenhum valor permanecer. Todas as modificações são executadas na ordem em que estão listadas.

Multithreading: as chamadas para ldap_modify_s são thread-safe.

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

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