funzione ldap_parse_vlv_controlA (winldap.h)

La funzione ldap_parse_vlv_control viene usata per trovare e analizzare i risultati della ricerca VLV.

Sintassi

WINLDAPAPI INT LDAPAPI ldap_parse_vlv_controlA(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPControlA *Control,
  [out] PULONG        TargetPos,
  [out] PULONG        ListCount,
  [out] PBERVAL       *Context,
  [out] PINT          ErrCode
);

Parametri

[in] ExternalHandle

Handle di sessione LDAP.

[in] Control

Indirizzo di una matrice con terminazione NULL di strutture LDAPControl, in genere ottenuto da una chiamata a ldap_parse_result.

[out] TargetPos

Posizione numerica della voce di destinazione nell'elenco dei set di risultati, come fornito dall'elemento targetPosition del controllo della risposta con codifica BER (LDAP_CONTROL_VLVRESPONSE). Se questo parametro è NULL, la posizione di destinazione non viene restituita.

[out] ListCount

Stima del server del numero di voci nell'elenco fornito dall'elemento contentCount del controllo della risposta con codifica BER (LDAP_CONTROL_VLVRESPONSE). Se questo parametro è NULL, le dimensioni non vengono restituite.

[out] Context

Identificatore di contesto generato dal server. Se il server non restituisce un identificatore di contesto, questo parametro verrà impostato su NULL. Se NULL viene passato per contextp, l'identificatore di contesto non viene restituito.

[out] ErrCode

Codice del risultato VLV, fornito dall'elemento virtualListViewResult del controllo risposta con codifica BER (LDAP_CONTROL_VLVRESPONSE). Se questo parametro è NULL, il codice del risultato non viene restituito.

Valore restituito

Questa funzione restituisce un codice di errore LDAP che indica se è stato trovato e analizzato correttamente un controllo dei risultati VLV. LDAP_SUCCESS viene restituito se tutto va bene, LDAP_CONTROL_MISSING viene restituito se la matrice ctrls non include un controllo di risposta (LDAP_CONTROL_VLVRESPONSE) e viene restituito un altro codice di errore LDAP se si verifica un errore di analisi o un altro problema.

VLV usa i codici di valore restituiti LDAP seguenti:

LDAP_OPERATIONS_ERROR

LDAP_UNWILLING_TO_PERFORM

LDAP_INSUFFICIENT_ACCESS

LDAP_BUSY

LDAP_TIMELIMIT_EXCEEDED

LDAP_ADMINLIMIT_EXCEEDED

LDAP_OTHER

Inoltre, sono stati aggiunti i due codici seguenti per supportare VLV:

Osservazioni

Questo controllo analizza i risultati della ricerca restituiti dal server nel controllo della risposta (LDAP_CONTROL_VLVRESPONSE). Un identificatore di contesto viene passato dal server al client per identificare il controllo, che deve essere liberato alla fine della sessione chiamando ber_bvfree.

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

Nota

L'intestazione winldap.h definisce ldap_parse_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_create_vlv_control

ldap_search_ext

ldap_search_ext_s

  • Last updated on