fonction ldap_parse_extended_resultA (winldap.h)

Article
20/11/2024

Le ldap_parse_extended_result analyse les résultats d’une opération étendue LDAP.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_parse_extended_resultA(
  [in]  LDAP        *Connection,
  [in]  LDAPMessage *ResultMessage,
  [out] PSTR        *ResultOID,
  [out] berval      **ResultData,
  [in]  BOOLEAN     Freeit
);

Paramètres

[in] Connection

Handle de session.

[in] ResultMessage

Pointeur vers une structure LDAPMessage retournée par ldap_result en réponse à une demande d’opération étendue.

[out] ResultOID

Pointeur vers une chaîne terminée par null qui contient la chaîne de texte OID (Object Identifier) en pointillé du message de réponse du serveur. Il s’agit normalement du même OID que celui qui nomme la requête qui a été passée initialement au serveur par ldap_extended_operation.

[out] ResultData

Données arbitraires retournées par l’opération étendue (si NULL, aucune donnée n’est retournée par le serveur).

[in] Freeit

Détermine si le paramètre ResultMessage est libéré. Vous pouvez transmettre n’importe quelle valeur différente de zéro au paramètre freeit pour libérer le pointeur ResultMessage lorsqu’il n’est plus nécessaire, ou vous pouvez appeler ldap_msgfree pour libérer le résultat ultérieurement.

Valeur de retour

Si la fonction réussit, la valeur de retour est LDAP_SUCCESS.

Si la fonction échoue, elle retourne un code d’erreur. Pour plus d’informations, consultez valeurs de retour.

Remarques

Lorsqu’un serveur traite une demande d’opération étendue générée par ldap_extended_operation, il retourne un message LDAP avec un code de retour LDAP_RES_EXTENDED. Utilisez ldap_parse_extended_result pour analyser ce message de résultat, qui retourne à la fois le texte OID du message d’origine dans ResultOID et toutes les données arbitraires générées par l’opération étendue dans ResultData.

Lorsqu’ils ne sont plus nécessaires, libérez la chaîne ResultOID et la mémoire tampon ResultData en appelant ldap_memfree.

Notes

L’en-tête winldap.h définit ldap_parse_extended_result en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	winldap.h
bibliothèque	Wldap32.lib
DLL	Wldap32.dll