função ldap_compare_s (winldap.h)

Artigo
03/08/2023

Use a função ldap_compare_s para determinar se um atributo para uma determinada entrada contém um valor conhecido.

Sintaxe

WINLDAPAPI ULONG LDAPAPI ldap_compare_s(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR attr,
  [in] PSTR       value
);

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 diferenciado da entrada.

[in] attr

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o atributo a ser comparado.

[in] value

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o valor do atributo de cadeia de caracteres a ser comparado ao valor do atributo.

Retornar valor

Se a função for bem-sucedida e o atributo e os valores conhecidos corresponderem, o valor retornado será LDAP_COMPARE_TRUE. Se os valores não corresponderem, o valor retornado será LDAP_COMPARE_FALSE.

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_compare_s inicia uma operação de comparação síncrona, comparando o valor de um atributo com um valor de cadeia de caracteres conhecido. Use ldap_compare_ext_s se precisar comparar valores binários. Use ldap_compare ou ldap_compare_ext para executar uma operação de comparação assíncrona.

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