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 a ser comparado ao 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 de retorno
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.
Observações
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 usar o parâmetro Data para comparar dados binários brutos. Defina o parâmetro não utilizado para 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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| servidor com suporte mínimo | Windows Server 2008 |
| da Plataforma de Destino |
Windows |
| cabeçalho | winldap.h |
| biblioteca | Wldap32.lib |
| de DLL |
Wldap32.dll |