SspiDeleteSecurityContextAsync 함수(sspi.h)

아티클
08/26/2023

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