funzione ldap_create_vlv_controlA (winldap.h)

La funzione ldap_create_vlv_control viene usata per creare il controllo della richiesta (LDAP_CONTROL_VLVREQUEST) nel server.

Sintassi

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

Parametri

[in] ExternalHandle

Handle di sessione LDAP, ottenuto da una chiamata a ldap_init.

[in] VlvInfo

Indirizzo di una struttura LDAPVLVInfo il cui contenuto viene utilizzato per costruire il valore del controllo creato.

[in] IsCritical

Se questo valore non è zero, il controllo creato avrà la sua criticità impostata su TRUE.

[out] Control

Un parametro di risultato ha assegnato l'indirizzo di una struttura LDAPControl che contiene il controllo della richiesta (LDAP_CONTROL_VLVREQUEST) creato da questa funzione.

Valore restituito

La funzione ldap_create_vlv_control restituisce un codice di errore LDAP per indicare un errore o LDAP_SUCCESS in caso di esito positivo.

Osservazioni

Quando viene eseguita una ricerca VLV, il client deve usare questa funzione per creare un nuovo controllo VLV che può essere incluso nella richiesta di ricerca inviata al server. Il server assegnerà un contextID per la ricerca VLV, passato al client. Al termine della ricerca VLV, è necessario usare ldap_control_free per liberare il controllo restituito da ldap_create_vlv_controle ldap_controls_free per liberare la matrice di controlli, incluso il controllo della risposta VLV, restituito da ldap_parse_result.

Per altre informazioni e un esempio di codice per questa funzione, vedere esempio di codice per l'uso di LDAP VLV.

Nota

L'intestazione winldap.h definisce ldap_create_vlv_control 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista
server minimo supportato Windows Server 2008
piattaforma di destinazione Finestre
intestazione winldap.h
libreria Wldap32.lib
dll Wldap32.dll

Vedere anche

LDAPControl

LDAPVLVInfo

LDAP_CONTROL_VLVREQUEST

LDAP_CONTROL_VLVRESPONSE

Ricerca con il controllo VLV LDAP

ldap_create_sort_control

ldap_parse_vlv_control

ldap_search_ext

ldap_search_ext_s

  • Last updated on