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 ).
Solaris: 9
Update 4 или выше.
FreeBSD:
FreeBSD 5.2 или выше
Linux: RedHat
7.3, RedHad 9.0.
Файл описания:
Прототип описан в файле sspi.h.
См. также:
FreeCredentialsHandle()
,AcceptSecurityContext()
,InitializeSecurityContext()
Крипто-Про SSPI Версия:
3.0 Сборка 3293