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

Статья
08/24/2023

Используйте функцию MprAdminInterfaceGetCredentialsEx , чтобы получить расширенные учетные данные для указанного интерфейса. Эта функция используется для получения сведений об учетных данных, используемых для расширяемых протоколов проверки подлинности (EAP).

Синтаксис

DWORD MprAdminInterfaceGetCredentialsEx(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Параметры

[in] hMprServer

Дескриптор маршрутизатора. Этот дескриптор получен из предыдущего вызова MprAdminServerConnect.

[in] hInterface

Дескриптор интерфейса. Этот дескриптор получен из предыдущего вызова MprAdminInterfaceCreate.

[in] dwLevel

Значение DWORD, описывающее формат, в котором возвращаются сведения в параметре lplpbBuffer . Допустимые значения для dwLevel включают 0 или 1, как указано в следующей таблице.

Значение	Формат структуры
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 или более поздней версии: MPR_CREDENTIALSEX_1

Значение 1 указывает, что сведения являются общим ключом для интерфейса в зашифрованном формате.

[out] lplpbBuffer

При успешном завершении указатель на MPR_CREDENTIALSEX_0 или MPR_CREDENTIALSEX_1 структуру. Параметр dwLevel указывает тип структуры. Освободите память, занимаемую этой структурой, с помощью MprAdminBufferFree.

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_HANDLE	Недопустимое значение hInterface .
ERROR_INVALID_PARAMETER	Параметр lplpbBuffer имеет значение NULL.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
ERROR_NOT_SUPPORTED	Недопустимое значение dwLevel .

Требования

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

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

MPR_CREDENTIALSEX_0

MPR_CREDENTIALSEX_1

MprAdminInterfaceCreate

MprAdminInterfaceGetCredentials

MprAdminInterfaceSetCredentialsEx

MprAdminServerConnect

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