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

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

  • Статья

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

Синтаксис

DWORD MprAdminServerGetCredentials(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Параметры

[in] hMprServer

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

[in] dwLevel

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

[out] lplpbBuffer

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

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

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

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

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

Комментарии

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

Требования

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

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

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

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

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