Крипто-Про SSPI

AcquireCredentialsHandle

Функция AcquireCredentialsHandle() создает дескриптор удостоверения субъекта безопасности, требуемый для функций InitializeSecurityContext и AcceptSecurityContext. 

SECURITY_STATUS AcquireCredentialsHandle(
  SEC_CHAR * pszPrincipal,
  SEC_CHAR * pszPackage,
  ULONG fCredentialUse,
  PLUID pvLogonID,
  PVOID pAuthData,
  PVOID pGetKeyFn,
  PVOID pvGetKeyArgument,
  PCredHandle phCredential,
  PTimeStamp ptsExpiry
);

Аргументы

pszPrincipal
[in] Параметр зарезервирован для будущего использования и должен быть NULL.
pszPackage
[in] Для SSL/TLS укажите UNISP_NAME (макрос, имеющий значение "Microsoft Unified Security Protocol Provider")
fCredentialUse
[in/out] Флаг возможного использования удостоверения:
Флаг Смысл
SECPKG_CRED_INBOUND Удостоверение сервера
SECPKG_CRED_OUTBOUND Удостоверение клиента
pvLogonID
[in] Параметр зарезервирован для будущего использования и должен быть NULL.
pAuthData
[in] Структура SCHANNEL_CRED, содержащая все настройки, в том числе (опционально) сертификат субъекта.
pGetKeyFn
[in] Параметр зарезервирован для будущего использования и должен быть NULL.
pvGetKeyArgument
[in] Параметр зарезервирован для будущего использования и должен быть NULL.
phCredential
[out] Указатель на CredHandle. Сюда будет записан дескриптор удостоверения.
ptsExpiry
[out] Опционален. Указатель на TimeStamp. Параметр зарезервирован для будущего использования и должен быть NULL.

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

Если функция завершается успешно, то возвращается SEC_E_OK. Иначе функция возвращает одно из следующих значений:
Коды возврата Описание
SEC_E_UNKNOWN_CREDENTIALS Параметр pAuthData содержал неподдерживаемое удостоверение.
SEC_E_NO_CREDENTIALS Параметр fCredentialUse имеет неправильное значение.

Примечания

Когда удостоверение больше не используется, освободите его вызовом FreeCredentialsHandle.

Требования:

Windows NT/2000/XP/2003: Необходимо Windows 2000 SP4 или старше с Internet Explorer 6.0 или старше.
Windows 95/98/ME: CSP 3.0 не поддерживает (см. КриптоПро CSP 2.0 World Wide Web link ).
Solaris: 9 Update 4 или выше.
FreeBSD: FreeBSD 5.2 или выше
Linux: RedHat 7.3, RedHad 9.0.
Файл описания: Прототип описан в файле sspi.h.

См. также:

FreeCredentialsHandle() ,AcceptSecurityContext() ,InitializeSecurityContext()

Крипто-Про SSPI Версия: 3.0 Сборка 3293
Что Вы думаете по поводу данной статьи?
 Закажите CD c Крипто-Про CSP