CREDENTIAL_TARGET_INFORMATIONA structure (wincred.h)

Article
03/03/2024

La structure CREDENTIAL_TARGET_INFORMATION contient le nom, le domaine et l’arborescence de l’ordinateur cible.

Syntaxe

typedef struct _CREDENTIAL_TARGET_INFORMATIONA {
  LPSTR   TargetName;
  LPSTR   NetbiosServerName;
  LPSTR   DnsServerName;
  LPSTR   NetbiosDomainName;
  LPSTR   DnsDomainName;
  LPSTR   DnsTreeName;
  LPSTR   PackageName;
  ULONG   Flags;
  DWORD   CredTypeCount;
  LPDWORD CredTypes;
} CREDENTIAL_TARGET_INFORMATIONA, *PCREDENTIAL_TARGET_INFORMATIONA;

Membres

TargetName

Nom du serveur cible tel que spécifié par l’appelant qui accède à la cible. Il s’agit généralement du nom NetBIOS ou DNS du serveur cible.

NetbiosServerName

Nom NetBIOS du serveur cible. Si le nom n’est pas connu, ce membre peut être NULL.

DnsServerName

Nom DNS du serveur cible. Si le nom n’est pas connu, ce membre peut être NULL.

NetbiosDomainName

Nom NetBIOS du domaine du serveur cible. Si le nom n’est pas connu, ce membre peut être NULL. Si le serveur cible est membre d’un groupe de travail, ce membre doit être NULL.

DnsDomainName

Nom DNS du domaine du serveur cible. Si le nom n’est pas connu, ce membre peut être NULL. Si le serveur cible est membre d’un groupe de travail, ce membre doit être NULL.

DnsTreeName

Nom DNS de l’arborescence du serveur cible. Si le nom de l’arborescence n’est pas connu, ce membre peut être NULL. Si le serveur cible est membre d’un groupe de travail, ce membre doit être NULL.

PackageName

Nom du package d’authentification qui a déterminé les valeurs NetbiosServerName, DnsServerName, NetbiosDomainName, DnsDomainName et DnsTreeName en tant que fonction de TargetName. Ce membre peut être passé à AcquireCredentialsHandle comme nom de package.

Flags

Attributs de la cible.

CRED_TI_SERVER_FORMAT_UNKNOWN
(1) : indique si le package d’authentification ne peut pas déterminer si le nom du serveur est un nom DNS ou un nom NetBIOS. Dans ce cas, le membre NetbiosServerName est défini sur NULL et le membre DnsServerName est défini sur le nom de serveur au format inconnu.
CRED_TI_DOMAIN_FORMAT_UNKNOWN
(2) : indique si le package d’authentification ne peut pas déterminer si le nom de domaine est un nom DNS ou un nom NetBIOS. Dans ce cas, le membre NetbiosDomainName est défini sur NULL et le membre DnsDomainName est défini sur le nom de domaine au format inconnu.
CRED_TI_ONLY_PASSWORD_REQUIRED
(4) : indique si le package d’authentification a déterminé que le serveur n’a besoin que d’un mot de passe pour s’authentifier. L’appelant peut utiliser cet indicateur pour demander uniquement un mot de passe et non un nom d’utilisateur.

Les informations d’identification stockées nécessitent un membre UserName. Une valeur dnsServerName><\Guest ou <NetbiosServerName>\Guest doit être utilisée pour ces serveurs.

CredTypeCount

Nombre d’éléments dans le tableau CredTypes .

CredTypes

Tableau spécifiant les types d’informations d’identification acceptables par le package d’authentification utilisé par le serveur cible. Chaque élément est l’un des CRED_TYPE_* définis. L’ordre de ce tableau spécifie l’ordre de préférence du package d’authentification. Des types plus préférables sont spécifiés plus haut dans la liste.

Remarques

Notes

L’en-tête wincred.h définit CREDENTIAL_TARGET_INFORMATION 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]
En-tête	wincred.h

Partager via