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


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

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

Синтаксис

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Параметры

[in] hMprServer

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

[in] hInterface

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

[in] dwLevel

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

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

[in] lpbBuffer

Указатель на структуру MPR_CREDENTIALSEX_0 или MPR_CREDENTIALSEX_1 . Параметр dwLevel указывает тип структуры.

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

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

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

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

Комментарии

Чтобы удалить общий ключ, вызовите MprAdminInterfaceSetCredentials с элементом dwSizeструктуры MPR_CREDENTIALSEX_1 , равным нулю.

Требования

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

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

MPR_CREDENTIALSEX_0

MPR_CREDENTIALSEX_1

MprAdminInterfaceCreate

MprAdminInterfaceSetCredentials

MprAdminInterfaceSetCredentialsEx

MprAdminServerConnect