funzione ldap_parse_result (winldap.h)

La funzione ldap_parse_result analizza le risposte dal server e restituisce i campi appropriati.

Sintassi

WINLDAPAPI ULONG LDAPAPI ldap_parse_result(
  [in]            LDAP          *Connection,
  [in]            LDAPMessage   *ResultMessage,
  [out, optional] ULONG         *ReturnCode,
  [out, optional] PSTR          *MatchedDNs,
  [out, optional] PSTR          *ErrorMessage,
  [out, optional] PSTR          **Referrals,
  [out, optional] PLDAPControlA **ServerControls,
  [in]            BOOLEAN       Freeit
);

Parametri

[in] Connection

Handle di sessione.

[in] ResultMessage

Risultato di un'operazione LDAP restituita da una delle chiamate di operazione sincrone o da ldap_result per un'operazione asincrona.

[out, optional] ReturnCode

Indica il risultato dell'operazione server che ha generato il messaggio di risultato originale. Passare NULL per ignorare questo campo.

[out, optional] MatchedDNs

Puntatore a una stringa con terminazione Null wide. Nel caso di una restituzione di LDAP_NO_SUCH_OBJECT, questo parametro di risultato viene compilato con un nome distinto che indica la quantità di nome nella richiesta riconosciuta. Passare NULL per ignorare questo campo.

[out, optional] ErrorMessage

Puntatore a una stringa con terminazione Null wide contenente il contenuto del campo del messaggio di errore del parametro ResultMessage . Passare NULL per ignorare questo campo.

[out, optional] Referrals

Puntatore a una stringa con terminazione Null wide contenente il contenuto del campo dei riferimenti dal parametro ResultMessage , che indica zero o più server LDAP alternativi in cui deve essere ritentata la richiesta. Passare NULL per ignorare questo campo.

[out, optional] ServerControls

Questo parametro di risultato viene compilato con una matrice allocata di controlli copiati dal parametro ResultMessage .

[in] Freeit

Determina se il parametro ResultMessage viene liberato. È possibile passare qualsiasi valore diverso da zero al parametro Freeit per liberare il puntatore ResultMessage quando non è più necessario oppure è possibile chiamare ldap_msgfree per liberare il risultato in un secondo momento.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene LDAP_SUCCESS.

Se la funzione non viene completata, restituisce un codice di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

La funzione ldap_parse_result attraversa una catena di risposte del server alla ricerca dei messaggi dei risultati da analizzare. Usare questa funzione se si desidera accedere alle segnalazioni, ai nomi distinti corrispondenti o ai controlli server restituiti. La funzione ignora i messaggi di tipo LDAP_RES_SEARCH_ENTRY e LDAP_RES_SEARCH_REFERENCE.

Quando non sono più necessari, liberare le stringhe ErrorMessage e MatchedDNs chiamando ldap_memfree. Liberare la matrice Segnalazioni chiamando ldap_value_free. Liberare ServerControls chiamando ldap_controls_free.

Requisiti

Vedi anche

Funzioni

Valori restituiti

ldap_controls_free

ldap_memfree

ldap_msgfree

ldap_result

ldap_value_free