SspiDeleteSecurityContextAsync 함수(sspi.h)
SspiDeleteSecurityContextAsync 함수는 SspiInitializeSecurityContextAsync 함수 또는 SspiAcceptSecurityContextAsync 함수에 대한 이전 호출에서 시작된 지정된 보안 컨텍스트와 연결된 로컬 데이터 구조를 삭제합니다.
구문
SECURITY_STATUS SspiDeleteSecurityContextAsync(
SspiAsyncContext *AsyncContext,
PCtxtHandle phContext
);
매개 변수
AsyncContext
비동기 호출 컨텍스트입니다.
phContext
삭제할 보안 컨텍스트의 핸들입니다.
반환 값
보안 컨텍스트를 삭제하기 위한 비동기 요청이 실행을 위해 성공적으로 큐에 대기 된 경우 SEC_E_OK 반환합니다. 그렇지 않으면 큐에 대기하려고 시도하여 생성된 오류를 반환합니다. 작업의 상태 검색하려면 SspiGetAsyncCallStatus를 사용합니다.
SspiGetAsyncCallStatus는 완료 시 SEC_E_OK 반환합니다. 그렇지 않으면 호출이 아직 진행 중인 경우 SEC_I_ASYNC_CALL_PENDING 반환하거나 아래 오류 코드 중 하나를 반환할 수 있습니다.
반환 코드 |
설명 |
---|---|
SEC_E_INVALID_HANDLE | 함수에 전달된 핸들이 잘못되었습니다. |
설명
비동기 호출이 완료되면 호출자는 새 SspiAsyncContext에 대한 콜백을 설정하지 않거나 Null 매개 변수가 있는 SspiSetAsyncNotifyCallback 을 사용하여 콜백을 제거하여 알림 수신을 옵트아웃하도록 선택할 수 있습니다. 옵트아웃하는 경우 컨텍스트를 다시 사용하려는 경우가 아니면 호출자는 SspiDeleteSecurityContextAsync를 호출한 직후 SspiFreeAsyncContext 를 사용하여 컨텍스트를 해제해야 합니다.
SspiDeleteSecurityContextAsync 함수는 보안 컨텍스트를 종료하고 연결된 리소스를 해제합니다.
호출자는 해당 보안 컨텍스트가 더 이상 필요하지 않은 경우 보안 컨텍스트에 대해 이 함수를 호출해야 합니다. 이는 보안 컨텍스트가 부분적이거나 불완전하거나 거부되거나 실패한 경우에 해당합니다. 보안 컨텍스트가 성공적으로 삭제되면 해당 보안 컨텍스트의 추가 사용이 허용되지 않으며 핸들이 더 이상 유효하지 않습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 10 버전 1607 [커널 모드 드라이버만 해당] |
지원되는 최소 서버 | Windows Server 2016 [커널 모드 드라이버만 해당] |
머리글 | sspi.h |
추가 정보
SspiAcceptSecurityContextAsync