função ldap_create_vlv_controlA (winldap.h)

Artigo
11/20/2024

A função ldap_create_vlv_control é usada para criar o controle de solicitação (LDAP_CONTROL_VLVREQUEST) no servidor.

Sintaxe

WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlA(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPVLVInfo  VlvInfo,
  [in]  UCHAR         IsCritical,
  [out] PLDAPControlA *Control
);

Parâmetros

[in] ExternalHandle

Um identificador de sessão LDAP, conforme obtido de uma chamada para ldap_init.

[in] VlvInfo

O endereço de uma estrutura LDAPVLVInfo cujo conteúdo é usado para construir o valor do controle criado.

[in] IsCritical

Se esse valor não for zero, o controle criado terá sua criticidade definida como TRUE.

[out] Control

Um parâmetro de resultado atribuiu o endereço de uma estrutura de LDAPControl que contém o controle de solicitação (LDAP_CONTROL_VLVREQUEST) criado por essa função.

Valor de retorno

A função ldap_create_vlv_control retorna um código de erro LDAP para indicar falha ou LDAP_SUCCESS se bem-sucedida.

Observações

Quando uma pesquisa VLV é realizada, o cliente deve usar essa função para criar um novo controle VLV que possa ser incluído na solicitação de pesquisa enviada ao servidor. O servidor atribuirá uma contextID para essa pesquisa VLV, passada para o cliente. Quando a pesquisa VLV for concluída, você deverá usar ldap_control_free para liberar o controle retornado por ldap_create_vlv_controle ldap_controls_free para liberar a matriz de controles, incluindo o controle de resposta VLV, retornado por ldap_parse_result.

Para obter mais informações e um exemplo de código para essa função, consulte código de exemplo para usarLDAP VLV.

Nota

O cabeçalho winldap.h define ldap_create_vlv_control 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