Fonction CredGetTargetInfoA (wincred.h)

La fonction CredGetTargetInfo récupère toutes les informations de nom de cible connues pour l’ordinateur cible nommé. Cette opération est exécutée localement et n’a pas besoin de privilège particulier. Les informations retournées sont censées être passées aux fonctions CredReadDomainCredentials et CredWriteDomainCredentials . Les informations ne doivent pas être utilisées à d’autres fins.

Les packages d’authentification calculent TargetInfo lors de la 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 de la cible ne seront disponibles qu’à partir d’une tentative récente d’authentification d’un TargetName.

Les packages d’authentification qui ne sont pas 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 CRED_CACHE_TARGET_INFORMATION.

Syntaxe

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *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 le fonctionnement de la fonction. L’indicateur suivant peut être utilisé :

CRED_ALLOW_NAME_RESOLUTION

Si aucune information cible ne peut être trouvée pour la résolution de noms TargetName est effectuée sur TargetName pour la convertir en d’autres formulaires. S’il existe des informations cibles pour l’un de ces autres formulaires, elles sont retournées. Actuellement, seule la résolution de noms DNS est effectuée.

Cela est utile si l’application n’appelle pas de package d’authentification directement. L’application peut passer le TargetName à une autre couche de logiciels pour s’authentifier auprès du serveur, et cette couche de logiciel peut résoudre le nom et passer le nom résolu au package d’authentification. Par conséquent, il n’y aura aucune information cible pour le TargetName d’origine.

[out] TargetInfo

Pointeur vers une mémoire tampon de bloc allouée unique pour contenir les informations de la cible. Au moins l’un des membres retournés de TargetInfo ne sera pas 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 retournée

La fonction retourne TRUE en cas de réussite et FALSE en cas d’échec. La fonction GetLastError peut être appelée pour obtenir un code status plus spécifique. Le code status suivant peut être retourné :

• ERROR_NOT_FOUND

  Les informations cibles pour le serveur nommé ne sont pas disponibles.

Remarques

Notes

L’en-tête wincred.h définit CredGetTargetInfo 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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincred.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

Obtenir la dernière erreur