структура 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 |