função ldap_set_option (winldap.h)
A função ldap_set_option define opções em blocos de conexão. Para obter mais informações sobre estruturas, consulte Estruturas de dados.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_set_option(
[in] LDAP *ld,
[in] int option,
[in] const void *invalue
);
Parâmetros
[in] ld
O identificador de sessão.
[in] option
O nome do conjunto de opções.
[in] invalue
Um ponteiro para o valor que a opção deve receber. O tipo real desse parâmetro depende da configuração do parâmetro option. As constantes LDAP_OPT_ON e LDAP_OPT_OFF podem ser fornecidas para opções que têm configurações ativadas ou desativadas.
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. Para obter mais informações, consulte Valores retornados.
Comentários
Chame ldap_set_option para acessar a estrutura LDAP que representa uma sessão LDAP. Não tente modificar a estrutura de dados LDAP diretamente.
Para obter mais informações e uma descrição das configurações opcionais que se aplicam a uma sessão LDAP, consulte Opções de sessão. Para obter mais informações sobre sinalizadores, consulte DsGetDcName.
Agora é possível assinar ou criptografar digitalmente todo o tráfego LDAP de e para um servidor LDAP do Windows usando o protocolo de autenticação Kerberos. Esse novo recurso fornece integridade e confidencialidade exigidas por alguns aplicativos. Lembre-se de que o uso da SSL (Secure Sockets Layer) lhe dará os mesmos benefícios, mas requer registros extensivos de certificado para o servidor e, às vezes, para o cliente.
Para habilitar a assinatura e a vedação, você precisa ativar uma das opções a seguir antes de chamar ldap_bind_s com LDAP_AUTH_NEGOTIATE para o método bind.
#define LDAP_OPT_SIGN 0x95
#define LDAP_OPT_ENCRYPT 0x96
Para desativar a assinatura e a vedação, feche a conexão chamando ldap_unbind() no identificador de conexão.
Multithreading: as chamadas para ldap_set_option não são seguras porque afetam a conexão como um todo. Tenha cuidado se os threads compartilharem conexões.
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 |