função cldap_open (winldap.h)

Artigo
03/04/2024

A função cldap_open estabelece uma sessão com um servidor LDAP em um serviço UDP (Protocolo de Datagrama de Usuário) sem conexão. Essa é uma alternativa ao uso de TCP/IP.

Sintaxe

WINLDAPAPI LDAP *LDAPAPI cldap_open(
  [in] PSTR  HostName,
  [in] ULONG PortNumber
);

Parâmetros

[in] HostName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém uma lista de nomes de host ou cadeias de caracteres pontilhadas que representam o endereço IP dos hosts do servidor LDAP. Use um único espaço para separar os nomes de host na lista. Cada nome de host na lista pode ser seguido por um número de porta. O número de porta opcional é separado do próprio host com dois-pontos (:). O tempo de execução LDAP tenta conexão com os hosts na ordem listada, parando quando uma conexão bem-sucedida é feita.

[in] PortNumber

O número da porta a ser usado. Se nenhum número de porta for especificado, o padrão será a porta 389, que é definida como LDAP_PORT. Se os números da porta estiverem incluídos no parâmetro HostName , esse parâmetro será ignorado.

Retornar valor

Se a função for bem-sucedida, um identificador de sessão, na forma de um ponteiro para uma estrutura LDAP será retornado. Libere o identificador de sessão com uma chamada para ldap_unbind quando não for mais necessário.

Se a função falhar, o valor retornado será NULL. Para obter o código de erro, chame LdapGetLastError ou a função Win32 GetLastError.

Comentários

A função cldap_open , ao contrário de ldap_open, cria um bloco de conexão para serviços LDAP baseados em UDP. Nenhuma sessão TCP é mantida. Como ldap_open, cldap_open aloca uma estrutura LDAP para manter dados de estado para a sessão e tenta fazer a conexão antes de retornar ao chamador. A chamada retorna um identificador de sessão, que você passa para chamadas de função LDAP subsequentes no decorrer da sessão. Quando terminar a sessão, sempre libere o identificador de sessão alocado usando ldap_unbind.

O uso do LDAP por UDP não dá suporte à associação e não dá suporte a TLS (SSL) ou SASL.

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

Nota Ao usar cldap_open, a conexão é aberta por um usuário anônimo. As únicas operações disponíveis são aquelas que um usuário anônimo pode executar.

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