структура 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть wincred.h