Estrutura LDAPControlA (winldap.h)
A estrutura de LDAPControl
Sintaxe
typedef struct ldapcontrolA {
PCHAR ldctl_oid;
struct berval ldctl_value;
BOOLEAN ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;
Membros
ldctl_oid
Ponteiro para uma cadeia de caracteres larga e terminada em nulo que indica o tipo de controle, como "1.2.840.113556.1.4.805".
ldctl_value
Os dados associados ao controle, se houver. Se nenhum dado estiver associado ao controle, defina esse membro como NULL.
ldctl_iscritical
Indica se o controle é crítico, chamado de campo Criticality.
Observações
A partir do LDAP 3, você pode estender as operações LDAP por meio do uso de controles. Os controles de servidor podem ser enviados para o servidor ou retornados ao cliente com qualquer mensagem LDAP. Os controles de cliente estendem o comportamento da API LDAP somente no lado do cliente e nunca são enviados para o servidor. Um controle com suporte é armazenado como um OID (identificador de objeto) na raiz do Serviço de Diretório.
O membro ldctl_iscritical permite que uma operação estendida tenha êxito quando o servidor ou cliente não dá suporte ao controle. Se o valor desse campo for zero, o servidor e/ou o cliente ignorarão o controle se ele não tiver suporte e realizar a operação. Se o valor não for zero, a operação será executada somente se o controle for reconhecido pelo servidor e/ou pelo cliente.
Para obter mais informações e uma lista dos controles estendidos LDAP com suporte e suas descrições, consulte Controles Estendidos.
Nota
O cabeçalho winldap.h define LDAPControl 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 |
| cabeçalho | winldap.h |