Функция MprAdminInterfaceSetCredentials (mprapi.h)

Статья
08/24/2023

Используйте функцию MprAdminInterfaceSetCredentials , чтобы задать домен, имя пользователя и пароль, которые будут использоваться для набора номера в указанном интерфейсе вызова по запросу.

Синтаксис

DWORD MprAdminInterfaceSetCredentials(
  [in] LPWSTR lpwsServer,
  [in] LPWSTR lpwsInterfaceName,
  [in] LPWSTR lpwsUserName,
  [in] LPWSTR lpwsDomainName,
  [in] LPWSTR lpwsPassword
);

Параметры

[in] lpwsServer

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

Этот параметр является необязательным. Если вызывающее приложение указывает значение NULL для этого параметра, вызов выполняется на локальном компьютере.

[in] lpwsInterfaceName

Указатель на строку Юникода, завершающуюся null, которая указывает имя интерфейса вызова по запросу. Чтобы получить имя интерфейса, используйте mprAdminInterfaceGetInfo .

[in] lpwsUserName

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

Этот параметр является необязательным. Если вызывающее приложение указывает значение NULL для этого параметра, функция не изменяет имя пользователя, связанное с этим интерфейсом.

[in] lpwsDomainName

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

Этот параметр является необязательным. Если вызывающее приложение задает для этого параметра значение NULL , функция не изменяет доменное имя, связанное с этим интерфейсом.

[in] lpwsPassword

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

Этот параметр является необязательным. Если вызывающее приложение указывает значение NULL для этого параметра, функция не изменяет пароль, связанный с этим интерфейсом.

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

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Значение	Значение
ERROR_INVALID_PARAMETER	Хотя бы одно из следующих утверждений верно: Параметр lpwsInterfaceName имеет значение NULL или длиннее MAX_INTERFACE_NAME_LEN. По крайней мере один из параметров lpwsUserName, lpwsPassword и lpwsDomainName слишком длинный и поэтому недопустим. Дополнительные сведения см. в разделе "Примечания".
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для создания новой структуры данных, содержащей учетные данные.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Параметры lpwsUserName, lpwsPassword и lpwsDomainName являются необязательными. Если вызывающее приложение задает значение NULL для всех трех параметров, MprAdminInterfaceSetCredentials удаляет все учетные данные для этого интерфейса.

Константы UNLEN, PWLEN и DNLEN — это максимальная длина имени пользователя, пароля и имени домена. Эти константы определяются в Lmcons.h.

Обратите внимание, что порядок параметров в MprAdminInterfaceSetCredentials отличается от mprAdminInterfaceGetCredentials.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mprapi.h
Библиотека	Mprapi.lib
DLL	Mprapi.dll