Функция
ApplyControlToken() используется для управления контекстом соединения.
SECURITY_STATUS ApplyControlToken(
PCtxtHandle phContext,
PSecBufferDesc pInput
);
Аргументы
- phContext
- [in] Дескриптор контекста.
- pInput
- [in] Структура SecBufferDesc, состоящая из единственной структуры SecBuffer. Буфер должен иметь тип SECBUFFER_TOKEN, длину sizeof(DWORD), и значение - DWORD, содержащее управляющую команду. В случае SCHANNEL_SESSION в буфере должна находиться структура SCHANNEL_SESSION_TOKEN Допустимые атрибуты перечислены в следующей таблице:
Значение | Операция |
SCHANNEL_SHUTDOWN | Нормальное завершение соединения с уведомлением другой стороны. |
SCHANNEL_RENEGOTIATE | Запрос переустановления соединения. |
SCHANNEL_SESSION |
dwFlags | Значение |
SSL_SESSION_ENABLE_RECONNECTS | Повторное использование соединения разрешено |
SSL_SESSION_DISABLE_RECONNECTS | Повторное использование соединения запрещено |
|
Возвращаемые значения
При успешном завершении функция возвращает SEC_E_OK.
В противном случае функция возвращает ненулевой код ошибки.
Примечания
За описанием того, как SSP уведомляет приложение на другой стороне о закрытии соединения командой SCHANNEL_SHUTDOWN см. заметки к DecryptMessage.
Требования:
AIX: 5.3 или выше.
FreeBSD: 7 или выше.
Linux: LSB 3.1 (RHEL 4, SuSE 10) или выше.
Solaris: 10 или выше.
Windows 2000 или выше: Необходимо Windows 2000 SP4 или старше с Internet Explorer 6.0 или старше.
Файл описания: Прототип описан в файле sspi.h для Windows и CSP_Sspi.h, CSP_SChannel.h, CpSSP.h для Unix.
См. также
DecryptMessage() ,SecBuffer ,SecBufferDesc