Функция CredGetTargetInfoW (wincred.h)

Статья
11/20/2024

Функция CredGetTargetInfo извлекает все известные сведения о имени целевого компьютера. Это выполняется локально и не требует каких-либо определенных привилегий. Ожидается, что возвращаемые сведения передаются в функции CredReadDomainCredentials и CredWriteDomainCredentials. Сведения не должны использоваться для других целей.

Пакеты проверки подлинности TargetInfo при попытке пройти проверку подлинности в TargetName. Пакеты проверки подлинности кэшируют эти целевые сведения, чтобы сделать его доступным для CredGetTargetInfo. Таким образом, целевые сведения будут доступны только из последней попытки проверки подлинности TargetName.

Пакеты проверки подлинности, не входящие в процесс LSA, могут кэшировать TargetInfo для последующего получения, CredGetTargetInfo путем вызова CredReadDomainCredentials с флагом CRED_CACHE_TARGET_INFORMATION.

Синтаксис

BOOL CredGetTargetInfoW(
  [in]  LPCWSTR                         TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONW *TargetInfo
);

Параметры

[in] TargetName

Указатель на строку, завершающуюся значением NULL, содержащую имя целевого компьютера, для которого требуется получить сведения.

[in] Flags

Флаги, управляющие операцией функции. Можно использовать следующий флаг:

CRED_ALLOW_NAME_RESOLUTION

Если для разрешения имен targetName targetName разрешение имен не найдено в TargetName, чтобы преобразовать его в другие формы. Если целевая информация существует для любой из этих других форм, возвращается. В настоящее время выполняется только разрешение DNS-имен.

Это полезно, если приложение не вызывает пакет проверки подлинности напрямую. Приложение может передать TargetName другому уровню программного обеспечения для проверки подлинности на сервере, и этот уровень программного обеспечения может разрешить имя и передать разрешенное имя пакету проверки подлинности. Таким образом, для исходного TargetNameне будет целевой информации.

[out] TargetInfo

Указатель на один выделенный буфер блока для хранения целевой информации. По крайней мере один из возвращенных элементов TargetInfo будет не null. Все указатели, содержащиеся в буфере, являются указателями на расположения в этом отдельном блоке. Один возвращаемый буфер должен быть освобожден путем вызова CredFree.

Возвращаемое значение

Функция возвращает TRUE при успешном выполнении и false при сбое. Функцию getLastError можно вызвать , чтобы получить более конкретный код состояния. Можно вернуть следующий код состояния:

ERROR_NOT_FOUND
Целевые сведения для именованного сервера недоступны.

Замечания

Заметка

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

Требования

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

См. также

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

GetLastError

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