Fonction AllocADsStr (adshlp.h)
La fonction AllocADsStr alloue de la mémoire pour et copie une chaîne spécifiée.
Syntaxe
LPWSTR AllocADsStr(
[in] LPCWSTR pStr
);
Paramètres
[in] pStr
Type : LPWSTR
Pointeur vers une chaîne Unicode terminée par null à copier.
Valeur retournée
Type : LPWSTR
En cas de réussite, la fonction retourne un pointeur non NULL vers la mémoire allouée. La chaîne dans pStr est copiée dans cette mémoire tampon et terminée par null. L’appelant doit libérer cette mémoire lorsqu’elle n’est plus nécessaire en passant le pointeur retourné à FreeADsStr.
Retourne la valeur NULL en cas de non-réussite. Appelez ADsGetLastError pour obtenir le status d’erreur étendu. Pour plus d’informations sur les valeurs de code d’erreur, consultez Codes d’erreur ADSI.
Remarques
Pour plus d’informations et un exemple de code qui montre comment utiliser la fonction AllocADsStr , consultez ReallocADsStr.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | adshlp.h |
| Bibliothèque | Activeds.lib |
| DLL | Activeds.dll |