Функция RKeyOpenKeyService

Статья
06/13/2023

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

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

Синтаксис

ULONG RKeyOpenKeyService(
  _In_    LPSTR          pszMachineName,
  _In_    KEYSVC_TYPE    OwnerType,
  _In_    LPWSTR         pwszOwnerName,
  _In_    void           *pAuthentication,
  _Inout_ void           *pReserved,
  _Out_   KEYSVCC_HANDLE *phKeySvcCli
);

Параметры

pszMachineName [in]

Длинный указатель на строку, завершающуюся значением NULL, которая представляет компьютер, на котором будет открыт дескриптор службы ключей.

OwnerType [in]

KEYSVC_TYPE значение, представляющее тип ключа. Единственное поддерживаемое значение — KeySvcMachine.

pwszOwnerName [in]

Зарезервировано. Присвойте этому значению значение NULL.

pAuthentication [in]

Указатель на объект void , представляющий параметры проверки подлинности. Этот указатель может указывать на нулевое или следующее значение.

Значение	Значение
RKEYSVC_CONNECT_SECURE_ONLY	Клиенту требуется взаимная проверка подлинности. Если это значение указано, возврат к NTLM завершится ошибкой.

pReserved [in, out]

Зарезервировано. Присвойте этому значению значение NULL.

phKeySvcCli [out]

Указатель на KEYSVCC_HANDLE , получающий открытый дескриптор службы ключа. Завершив использование дескриптора, освободите ресурс, вызвав функцию RKeyCloseKeyService .

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

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

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

Требования

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

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

RKeyCloseKeyService
RKeyPFXInstall