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

Статья
03/05/2024

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

Синтаксис

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

Параметры

[in] User

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

[in] Domain

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

[in] Password

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

[out] pAuthIdentity

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

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

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

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

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ntdsapi.h
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll