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

Статья
08/24/2023

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

Синтаксис

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

Параметры

[in] lpwsServer

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

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

[in] lpwsInterfaceName

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

[out] lpwsUserName

Указатель на строку Юникода, получающую имя пользователя. Эта строка должна иметь длину UNLEN+1.

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

[out] lpwsPassword

Указатель на строку Юникода, получающую пароль. Эта строка должна иметь длину PWLEN+1.

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

[out] lpwsDomainName

Указатель на строку Юникода, получающую доменное имя. Эта строка должна иметь длину DNLEN+1.

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

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

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

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

Значение	Значение
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Указанный интерфейс не имеет связанных с ним параметров набора по запросу.
ERROR_INVALID_PARAMETER	Параметр lpwsInterfaceName имеет значение NULL.
NO_ERROR	Параметры lpwsUserName, lpwsPassword и lpwsDomainName имеют значение NULL.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Параметры lpwsUserName, lpwsPassword и lpwsDomainName являются необязательными. Если вызывающее приложение задает значение NULL для всех трех параметров, MprAdminInterfaceGetCredentials возвращает NO_ERROR а домен, имя пользователя и пароль не возвращаются.

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

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

Требования


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

См. также раздел

FormatMessage

MprAdminInterfaceSetCredentials

Функции администрирования маршрутизатора

Справочник по управлению маршрутизаторами

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