funzione ldap_result (winldap.h)

La funzione ldap_result ottiene il risultato di un'operazione asincrona.

Sintassi

WINLDAPAPI ULONG LDAPAPI ldap_result(
  [in]  LDAP          *ld,
  [in]  ULONG         msgid,
  [in]  ULONG         all,
  [in]  PLDAP_TIMEVAL timeout,
  [out] PLDAPMessage  *res
);

Parametri

[in] ld

Handle di sessione.

[in] msgid

ID messaggio dell'operazione o costante LDAP_RES_ANY se è necessario un risultato.

[in] all

Specifica il numero di messaggi recuperati in una singola chiamata a ldap_result. Questo parametro ha significato solo per i risultati della ricerca. Passare il LDAP_MSG_ONE costante (0x00) per recuperare un messaggio alla volta. Passare LDAP_MSG_ALL (0x01) per richiedere che tutti i risultati di una ricerca vengano ricevuti prima di restituire tutti i risultati in una singola catena. Passare LDAP_MSG_RECEIVED (0x02) per indicare che tutti i risultati recuperati finora devono essere restituiti nella catena di risultati.

[in] timeout

Timeout che specifica per quanto tempo, in secondi, attendere la restituzione dei risultati. Un valore NULL fa sì che ldap_result blocchi fino a quando i risultati non sono disponibili. Un valore di timeout pari a zero secondi specifica un comportamento di polling.

[out] res

Contiene i risultati dell'operazione. Tutti i risultati restituiti devono essere liberati con una chiamata a ldap_msgfree una volta che non sono più richiesti dall'applicazione.

Valore restituito

Se la funzione ha esito positivo, restituisce uno dei valori seguenti per indicare il tipo del primo risultato nel parametro res . Se il timeout scade, la funzione restituisce 0.

Se la funzione ha esito negativo, restituisce –1 e imposta i parametri di errore della sessione nella struttura dei dati LDAP.

Commenti

La funzione ldap_result recupera il risultato di un'operazione precedente avviata in modo asincrono. Tenere presente che, a seconda del modo in cui viene chiamato, ldap_result può effettivamente restituire un elenco o una "catena" di messaggi.

Per LDAP senza connessione, è necessario passare sia un handle di connessione LDAP che un ID messaggio per assicurarsi di ottenere i risultati corretti. Il runtime LDAP continua a inviare la richiesta fino a quando non riceve una risposta.

Multithreading: le chiamate a ldap_result sono thread-safe.

Requisiti

Vedi anche

Funzioni

ldap_msgfree