Функция DsMakePasswordCredentialsA (ntdsapi.h)

Статья
11/20/2024

Функция DsMakePasswordCredentials создает дескриптор учетных данных, подходящий для использования с функцией DsBindWithCred.

Синтаксис

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

Параметры

[in] User

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

[in] Domain

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

[in] Password

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

[out] pAuthIdentity

Указатель на значение RPC_AUTH_IDENTITY_HANDLE, которое получает дескриптор учетных данных. Этот дескриптор используется в последующем вызове DsBindWithCred. Этот дескриптор должен быть освобожден с помощью функции DsFreePasswordCredentials, если она больше не требуется.

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

Возвращает код ошибки Windows, включая следующее.

Замечания

Маркер учетных данных по умолчанию создается, если user, Домен и пароль все NULL. В противном случае должен присутствовать пользователя. Параметр домена может быть NULL, если пользователь является полным, например пользователь в формате имени участника-пользователя; например, "someone@fabrikam.com".

Когда дескриптор, возвращенный в pAuthIdentity, передается в DsBindWithCred, DsUnBind необходимо вызвать перед освобождением дескриптора с помощью DsFreePasswordCredentials. Обычная последовательность:

Вызовите DsMakePasswordCredentials, чтобы получить дескриптор учетных данных.
Вызовите DsBindWithCredи передайте дескриптор учетных данных.
Вызовите DsUnbind, если привязка больше не требуется.
Вызовите DsFreePasswordCredentials, чтобы освободить дескриптор учетных данных.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll

См. также

функции управления доменами и репликацией

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE

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