Struttura LDAPControlA (winldap.h)

La struttura LDAPControl rappresenta sia i controlli lato client che i controlli server.

Sintassi

typedef struct ldapcontrolA {
  PCHAR         ldctl_oid;
  struct berval ldctl_value;
  BOOLEAN       ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;

Members

ldctl_oid

Puntatore a una stringa con terminazione Null wide che indica il tipo di controllo, ad esempio "1.2.840.113556.1.4.805".

ldctl_value

Dati associati al controllo, se presenti. Se al controllo non sono associati dati, impostare questo membro su NULL.

ldctl_iscritical

Indica se il controllo è critico, denominato campo Criticità.

Commenti

A partire da LDAP 3, è possibile estendere le operazioni LDAP tramite l'uso dei controlli. I controlli server possono essere inviati al server o restituiti al client con qualsiasi messaggio LDAP. I controlli client estendono il comportamento dell'API LDAP solo sul lato client e non vengono mai inviati al server. Un controllo supportato viene archiviato come identificatore di oggetto (OID) nella radice del servizio directory.

Il membro ldctl_iscritical consente l'esito positivo di un'operazione estesa quando il server o il client non supporta il controllo. Se il valore di questo campo è zero, il server e/o il client ignorano il controllo se non è supportato ed esegue l'operazione. Se il valore è diverso da zero, l'operazione viene eseguita solo se il controllo viene riconosciuto dal server e/o dal client.

Per altre informazioni e un elenco dei controlli estesi LDAP supportati e delle relative descrizioni, vedere Controlli estesi.

Nota

L'intestazione winldap.h definisce LDAPControl come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	winldap.h

Vedi anche

strutture di dati

LDAPMessage

Uso dei controlli