função ldap_compare_ext_sW (winldap.h)

Artigo
03/08/2023

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

Sintaxe

WINLDAPAPI ULONG LDAPAPI ldap_compare_ext_sW(
  [in] LDAP          *ld,
  [in] const PWSTR   dn,
  [in] const PWSTR   Attr,
  [in] const PWSTR   Value,
  [in] berval        *Data,
  [in] PLDAPControlW *ServerControls,
  [in] PLDAPControlW *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 diferenciado da entrada a ser comparada.

[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. Defina como NULL se não for usado.

[in] Data

O valor do atributo berval a ser comparado com o valor do atributo. Defina como NULL se não for usado.

[in] ServerControls

Opcional. Uma lista de controles de servidor LDAP. Defina como NULL se não for usado.

[in] ClientControls

Opcional. Uma lista de controles de cliente LDAP. Defina como NULL se não for usado.

Valor retornado

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

Se a função falhar, um código de erro será retornado. Para obter mais informações, consulte Valores retornados.

Comentários

A função ldap_compare_ext_s inicia uma operação de comparação síncrona, comparando o valor de um atributo com um valor conhecido. Os parâmetros e efeitos de ldap_compare_ext_s subsume os de ldap_compare_s. A rotina estendida inclui parâmetros adicionais para dar suporte a controles de cliente e servidor e comparação de valores binários.

Use o parâmetro Value para comparar valores de cadeia de caracteres ou use o parâmetro Data para comparar dados binários brutos. Defina o parâmetro não utilizado como NULL. Se nenhum dos parâmetros for NULL, a operação de comparação usará o valor no parâmetro Data .

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

Observação

O cabeçalho winldap.h define ldap_compare_ext_s como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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