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


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

Функции MprAdminServerSetCredentials задают общий ключ для указанного сервера.

Синтаксис

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Параметры

[in] hMprServer

Дескриптор на сервере Windows. Получите этот дескриптор, вызвав MprAdminMIBServerConnect.

[in] dwLevel

Значение DWORD, описывающее формат, в котором сведения структурированы в параметре lpbBuffer . Должен равняться нулю.

[in] lpbBuffer

Указатель на структуру MPR_CREDENTIALSEX_1 , содержащую общий ключ для сервера.

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

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

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

Значение Значение
ERROR_ACCESS_DENIED
Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_PARAMETER
Параметр lpbBuffer имеет значение NULL.
ERROR_NOT_SUPPORTED
Параметр dwLevel не равен нулю.
Другое
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Комментарии

Сервер поддерживает один общий ключ для всех пользователей.

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

Требования

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

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

MPR_CREDENTIALSEX_1

MprAdminServerGetCredentials

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

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