Функция TLSGetServerCertificate

Статья
06/12/2023

Возвращает сертификат сервера лицензирования удаленного рабочего стола.

Примечание

У этой функции нет связанного файла заголовка или библиотеки импорта. Чтобы вызвать эту функцию, необходимо создать определяемый пользователем файл заголовка и использовать функции LoadLibrary и GetProcAddress для динамической связи с Mstlsapi.dll.

Синтаксис

DWORD WINAPI TLSGetServerCertificate(
  _In_  TLS_HANDLE hHandle,
  _In_  BOOL       bSignCert,
  _Out_ LPBYTE     *ppbCertBlob,
  _Out_ LPDWORD    lpdwCertBlobLen,
  _Out_ PDWORD     pdwErrCode
);

Параметры

hHandle [in]: Обработка сервера лицензирования удаленного рабочего стола, который открывается вызовом функции TLSConnectToLsServer .
bSignCert [in]: True , если сертификат подписи, false , если сертификат exchange.
ppbCertBlob [out]: Указатель на переменную, получающую указатель на буфер, содержащий сертификат.
lpdwCertBlobLen [out]: Указатель на переменную, которая получает размер возвращаемого сертификата.
pdwErrCode [out]: Указатель на переменную, получающую код ошибки.
LSERVER_S_SUCCESS (0): Вызов выполнен успешно.
TLS_W_SELFSIGN_CERTIFICATE (4007): Возвращенный сертификат — это самозаверяющий сертификат.
TLS_W_TEMP_SELFSIGN_CERT (4009): Возвращенный сертификат является временным.
TLS_E_ACCESS_DENIED (5003): Доступ запрещен.
TLS_E_ALLOCATE_HANDLE (5007): Сервер слишком занят для обработки запроса.
TLS_E_NO_CERTIFICATE (5022): Не удается получить сертификат.

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

Эта функция возвращает следующие возможные возвращаемые значения.

RPC_S_OK: Вызов выполнен успешно. Проверьте значение параметра pdwErrCode , чтобы получить код возврата для вызова.
RPC_S_INVALID_ARG: Недопустимое значение аргумента.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
DLL	Mstlsapi.dll

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

TLSConnectToLsServer

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