função ldap_compare_ext_sW (winldap.h)
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 |