AcquireCredentialsHandle

Cоздает дескриптор удостоверения субъекта безопасности, требуемый для функций 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")

phContext

[in] Дескриптор контекста соединения, установленного с получателем сообщения.

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. Иначе функция возвращает одно из следующих значений:

Примечание:

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

Требования:

Windows NT/2000/XP: Необходимо Windows NT 4.0 SP5 или старше с Internet Explorer 5.0 или старше.
Windows 98/ME: Необходимо Windows 95 OSR2 или старше с Internet Explorer 5.0 или старше.
Файл описания: Прототип описан в файле Sspi.h.

См. также:

FreeCredentialsHandle() , AcceptSecurityContext() , InitializeSecurityContext()