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


Функция PeerIdentityGetCryptKey (p2p.h)

Функция PeerIdentityGetCryptKey извлекает дескриптор для поставщика служб шифрования (CSP).

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetCryptKey(
  [in]  PCWSTR     pwzIdentity,
  [out] HCRYPTPROV *phCryptProv
);

Параметры

[in] pwzIdentity

Указывает удостоверение однорангового узла, для которого извлекается пара ключей.

[out] phCryptProv

Получает указатель на дескриптор поставщика служб шифрования (CSP), который содержит AT_KEYEXCHANGE пару ключей RSA.

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

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

Код возврата Описание
E_INVALIDARG
Один из параметров недопустим.
E_OUTOFMEMORY
Недостаточно памяти для выполнения указанной операции.
PEER_E_NO_KEY_ACCESS
Доступ к удостоверению однорангового узла или ключам группы одноранговых узлов запрещен. Как правило, это вызвано неправильным списком управления доступом (ACL) для папки, содержащей ключи пользователя или компьютера. Это может произойти, если список ACL был сброшен вручную.
PEER_E_NOT_FOUND
Не удается найти удостоверение, соответствующее указанному имени.

Комментарии

Ключ можно получить, вызвав CryptGetUserKey.

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

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2P.lib
DLL P2P.dll

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

CryptGetUserKey

CryptReleaseContext