Функция RKeyPFXInstall

Статья
06/13/2023

Функция RKeyPFXInstall не поддерживается.

Windows Server 2003: Функция RKeyPFXInstall устанавливает сертификат на удаленном компьютере. Обратите внимание, что это поведение изменилось в Windows Server 2003 с пакетом обновления 1 (SP1).

Синтаксис

ULONG RKeyPFXInstall(
  _In_ KEYSVCC_HANDLE         hKeySvcCli,
  _In_ PKEYSVC_BLOB           pPFX,
  _In_ PKEYSVC_UNICODE_STRING pPassword,
  _In_ ULONG                  ulFlags
);

Параметры

hKeySvcCli [in]

Дескриптор KEYSVCC_HANDLE , ранее открытый RKeyOpenKeyService. Дескриптор представляет удаленный компьютер, который получит сертификат. Это значение не может иметь значение NULL.

pPFX [in]

Указатель на структуру KEYSVC_BLOB , представляющую сертификат для установки. Большой двоичный объект имеет формат PKCS 12 .

pPassword [in]

Указатель на структуру KEYSVC_UNICODE_STRING , представляющую пароль для большого двоичного объекта. Завершив использование пароля, очистите его из памяти, вызвав функцию SecureZeroMemory . Дополнительные сведения о защите паролей см. в разделе Обработка паролей.

ulFlags [in]

Флаги, указывающие параметры установки сертификата. Этот параметр может быть нулем или сочетанием следующих значений.

Значение	Значение
CRYPT_EXPORTABLE	Импортированные ключи помечаются как доступные для экспорта.
CRYPT_MACHINE_KEYSET	Закрытые ключи хранятся на удаленном компьютере, а не под текущим пользователем.

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

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

Если функция завершается ошибкой, возвращается значение ULONG , указывающее на ошибку.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Rkeysvcc.h

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

RKeyCloseKeyService
RKeyOpenKeyService

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