Skip to content

Latest commit

 

History

History
182 lines (115 loc) · 6.69 KB

ns-wincred-credential_target_informationw.md

File metadata and controls

182 lines (115 loc) · 6.69 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:wincred._CREDENTIAL_TARGET_INFORMATIONW
CREDENTIAL_TARGET_INFORMATIONW (wincred.h)
The CREDENTIAL_TARGET_INFORMATION structure contains the target computer's name, domain, and tree. (Unicode)
*PCREDENTIAL_TARGET_INFORMATIONW
CREDENTIAL_TARGET_INFORMATION
CREDENTIAL_TARGET_INFORMATION structure [Security]
CREDENTIAL_TARGET_INFORMATIONW
PCREDENTIAL_TARGET_INFORMATION
PCREDENTIAL_TARGET_INFORMATION structure pointer [Security]
_cred_credential_target_information
security.credential_target_information
wincred/CREDENTIAL_TARGET_INFORMATION
wincred/PCREDENTIAL_TARGET_INFORMATION
security\credential_target_information.htm
security
92180f2c-ef7c-4481-9b6f-19234c114afb
12/05/2018
*PCREDENTIAL_TARGET_INFORMATIONW, CREDENTIAL_TARGET_INFORMATION, CREDENTIAL_TARGET_INFORMATION structure [Security], CREDENTIAL_TARGET_INFORMATIONW, PCREDENTIAL_TARGET_INFORMATION, PCREDENTIAL_TARGET_INFORMATION structure pointer [Security], _cred_credential_target_information, security.credential_target_information, wincred/CREDENTIAL_TARGET_INFORMATION, wincred/PCREDENTIAL_TARGET_INFORMATION
wincred.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
CREDENTIAL_TARGET_INFORMATIONW, *PCREDENTIAL_TARGET_INFORMATIONW
19H1
_CREDENTIAL_TARGET_INFORMATIONW
wincred/_CREDENTIAL_TARGET_INFORMATIONW
PCREDENTIAL_TARGET_INFORMATIONW
wincred/PCREDENTIAL_TARGET_INFORMATIONW
CREDENTIAL_TARGET_INFORMATIONW
wincred/CREDENTIAL_TARGET_INFORMATIONW
c++
APIRef
kbSyntax
HeaderDef
WinCred.h
CREDENTIAL_TARGET_INFORMATION

CREDENTIAL_TARGET_INFORMATIONW structure

-description

The CREDENTIAL_TARGET_INFORMATION structure contains the target computer's name, domain, and tree.

-struct-fields

-field TargetName.string

-field TargetName.max_is

-field TargetName.max_is.CRED_MAX_DOMAIN_TARGET_NAME_LENGTH-1

-field NetbiosServerName.string

-field NetbiosServerName.max_is

-field NetbiosServerName.max_is.CRED_MAX_DOMAIN_TARGET_NAME_LENGTH-1

-field DnsServerName.string

-field DnsServerName.max_is

-field DnsServerName.max_is.CRED_MAX_DOMAIN_TARGET_NAME_LENGTH-1

-field NetbiosDomainName.string

-field NetbiosDomainName.max_is

-field NetbiosDomainName.max_is.CRED_MAX_DOMAIN_TARGET_NAME_LENGTH-1

-field DnsDomainName.string

-field DnsDomainName.max_is

-field DnsDomainName.max_is.CRED_MAX_DOMAIN_TARGET_NAME_LENGTH-1

-field DnsTreeName.string

-field DnsTreeName.max_is

-field DnsTreeName.max_is.CRED_MAX_DOMAIN_TARGET_NAME_LENGTH-1

-field PackageName.string

-field PackageName.max_is

-field PackageName.max_is.CRED_MAX_STRING_LENGTH-1

-field TargetName

Name of the target server as specified by the caller accessing the target. It is typically the NetBIOS or DNS name of the target server.

-field NetbiosServerName

NetBIOS name of the target server. If the name is not known, this member can be NULL.

-field DnsServerName

DNS name of the target server. If the name is not known, this member can be NULL.

-field NetbiosDomainName

NetBIOS name of the target server's domain. If the name is not known, this member can be NULL. If the target server is a member of a workgroup, this member must be NULL.

-field DnsDomainName

DNS name of the target server's domain. If the name is not known, this member can be NULL. If the target server is a member of a workgroup, this member must be NULL.

-field DnsTreeName

DNS name of the target server's tree. If the tree name is not known, this member can be NULL. If the target server is a member of a workgroup, this member must be NULL.

-field PackageName

Name of the authentication package that determined the values NetbiosServerName, DnsServerName, NetbiosDomainName, DnsDomainName, and DnsTreeName as a function of TargetName. This member can be passed to AcquireCredentialsHandle as the package name.

-field Flags

Attributes of the target.

  • CRED_TI_SERVER_FORMAT_UNKNOWN

    (1) — Set if the authentication package cannot determine whether the server name is a DNS name or a NetBIOS name. In that case, the NetbiosServerName member is set to NULL and the DnsServerName member is set to the server name of unknown format.

  • CRED_TI_DOMAIN_FORMAT_UNKNOWN

    (2) — Set if the authentication package cannot determine whether the domain name is a DNS name or a NetBIOS name. In that case, the NetbiosDomainName member is set to NULL and the DnsDomainName member is set to the domain name of unknown format.

  • CRED_TI_ONLY_PASSWORD_REQUIRED

    (4) — Set if the authentication package has determined that the server only needs a password to authenticate. The caller can use this flag to prompt only for a password and not a user name.

    Stored credentials require a UserName member. A value of <DnsServerName>\Guest or <NetbiosServerName>\Guest should be used for these servers.

-field CredTypeCount

Number of elements in the CredTypes array.

-field CredTypeCount.range

-field CredTypeCount.range.0

-field CredTypeCount.range.CRED_TYPE_MAXIMUM_EX

-field CredTypes

Array specifying the credential types acceptable by the authentication package used by the target server. Each element is one of the CRED_TYPE_* defines. The order of this array specifies the preference order of the authentication package. More preferable types are specified earlier in the list.

-field CredTypes.size_is

-field CredTypes.size_is.CredTypeCount

-remarks

Note

The wincred.h header defines CREDENTIAL_TARGET_INFORMATION as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.