CredGetTargetInfoW, fonction (wincred.h)
La fonction CredGetTargetInfo récupère toutes les informations de nom cible connues pour l’ordinateur cible nommé. Cette opération s’exécute localement et n’a pas besoin d’un privilège particulier. Les informations retournées doivent être transmises aux fonctions CredReadDomainCredentials et CredWriteDomainCredentials. Les informations ne doivent pas être utilisées à d’autres fins.
Les packages d’authentification calculent TargetInfo lors d’une tentative d’authentification auprès d’un TargetName. Les packages d’authentification mettent en cache ces informations cibles pour les rendre disponibles pour CredGetTargetInfo. Par conséquent, les informations cibles ne seront disponibles qu’à partir d’une tentative récente d’authentification d’une TargetName.
Les packages d’authentification non dans le processus LSA peuvent mettre en cache un TargetInfo pour une récupération ultérieure par CredGetTargetInfo en appelant CredReadDomainCredentials avec l’indicateur de CRED_CACHE_TARGET_INFORMATION.
Syntaxe
BOOL CredGetTargetInfoW(
[in] LPCWSTR TargetName,
[in] DWORD Flags,
[out] PCREDENTIAL_TARGET_INFORMATIONW *TargetInfo
);
Paramètres
[in] TargetName
Pointeur vers une chaîne terminée par null qui contient le nom de l’ordinateur cible pour lequel les informations doivent être récupérées.
[in] Flags
Indicateurs contrôlant l’opération de la fonction. L’indicateur suivant peut être utilisé :
CRED_ALLOW_NAME_RESOLUTION
Si aucune information cible n’est disponible pour résolution de noms targetName est effectuée sur TargetName pour la convertir en d’autres formulaires. Si des informations cibles existent pour l’une de ces autres formes, elle est retournée. Actuellement, seule la résolution de noms DNS est effectuée.
Cela est utile si l’application n’appelle pas directement un package d’authentification. L’application peut passer l'TargetName à une autre couche de logiciels pour s’authentifier auprès du serveur, et cette couche de logiciels peut résoudre le nom et transmettre le nom résolu au package d’authentification. Par conséquent, il n’y aura aucune information cible pour l'TargetName d’origine.
[out] TargetInfo
Pointeur vers une mémoire tampon de bloc allouée unique pour contenir les informations cibles. Au moins un des membres retournés de TargetInfo n’a pas la valeur NULL. Tous les pointeurs contenus dans la mémoire tampon sont des pointeurs vers des emplacements au sein de ce bloc alloué unique. La mémoire tampon retournée unique doit être libérée en appelant CredFree.
Valeur de retour
La fonction retourne TRUE en cas de réussite et FAUX en cas d’échec. La fonction GetLastError peut être appelée pour obtenir un code d’état plus spécifique. Le code d’état suivant peut être retourné :
- ERROR_NOT_FOUND
Les informations cibles du serveur nommé ne sont pas disponibles.
Remarques
Note
L’en-tête wincred.h définit CredGetTargetInfo comme 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 XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | wincred.h |
| bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |