Поделиться через

структура CREDENTIAL_TARGET_INFORMATIONA (wincred.h)

  • Статья

Структура CREDENTIAL_TARGET_INFORMATION содержит имя, домен и дерево целевого компьютера.

Синтаксис

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;

Члены

TargetName

Имя целевого сервера, указанного вызывающим объектом, который обращается к целевому объекту. Обычно это netBIOS или DNS-имя целевого сервера.

NetbiosServerName

NetBIOS-имя целевого сервера. Если имя не известно, этот элемент может быть null.

DnsServerName

DNS-имя целевого сервера. Если имя не известно, этот элемент может быть null.

NetbiosDomainName

NetBIOS-имя домена целевого сервера. Если имя не известно, этот элемент может быть null. Если целевой сервер является членом рабочей группы, этот элемент должен быть NULL.

DnsDomainName

DNS-имя домена целевого сервера. Если имя не известно, этот элемент может быть null. Если целевой сервер является членом рабочей группы, этот элемент должен быть NULL.

DnsTreeName

DNS-имя дерева целевого сервера. Если имя дерева неизвестно, этот элемент может быть NULL. Если целевой сервер является членом рабочей группы, этот элемент должен быть NULL.

PackageName

Имя пакета проверки подлинности, определяющего значения NetbiosServerName, DnsServerName, NetbiosDomainName, DnsDomainName, а DnsTreeName в качестве функции TargetName. Этот элемент можно передать в AcquireCredentialsHandle в качестве имени пакета.

Flags

Атрибуты целевого объекта.

  • CRED_TI_SERVER_FORMAT_UNKNOWN

    (1) — если пакет проверки подлинности не может определить, является ли имя сервера DNS-именем или именем NetBIOS. В этом случае элемент NetbiosServerName имеет значение NULL, а для элемента dnsServerName задано имя сервера неизвестного формата.

  • CRED_TI_DOMAIN_FORMAT_UNKNOWN

    (2) — установка, если пакет проверки подлинности не может определить, является ли доменное имя DNS-именем или именем NetBIOS. В этом случае элемент NetbiosDomainName имеет значение NULL, а элемент DnsDomainName имеет доменное имя неизвестного формата.

  • CRED_TI_ONLY_PASSWORD_REQUIRED

    (4) — установка, если пакет проверки подлинности определил, что серверу требуется только пароль для проверки подлинности. Вызывающий объект может использовать этот флаг, чтобы запрашивать только пароль, а не имя пользователя.

    Для сохраненных учетных данных требуется элемент UserName. Значение <DnsServerName>\Guest или <NetbiosServerName>\Guest следует использовать для этих серверов.

CredTypeCount

Количество элементов в массиве CredTypes.

CredTypes

Массив, указывающий типы учетных данных, допустимые пакетом проверки подлинности, используемым целевым сервером. Каждый элемент является одним из определяемых CRED_TYPE_*. Порядок этого массива определяет порядок предпочтений пакета проверки подлинности. Более предпочтительнее типы указываются ранее в списке.

Замечания

Заметка

Заголовок wincred.h определяет CREDENTIAL_TARGET_INFORMATION как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка wincred.h