다음을 통해 공유

Tbsi_Context_Create 함수(tbs.h)

  • 아티클

TBS에 명령을 전달하는 데 사용할 수 있는 컨텍스트 핸들을 만듭니다.

구문

TBS_RESULT Tbsi_Context_Create(
  [in]  PCTBS_CONTEXT_PARAMS pContextParams,
  [out] PTBS_HCONTEXT        phContext
);

매개 변수

[in] pContextParams

컨텍스트와 연결된 매개 변수를 포함하는 TBS_CONTEXT_PARAMS 구조체에 대한 매개 변수입니다.

[out] phContext

새 컨텍스트 핸들을 저장할 위치에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 TBS_SUCCESS 반환합니다.

함수가 실패하면 오류를 나타내는 TBS 반환 코드를 반환합니다.

반환 코드/값 설명
TBS_SUCCESS
0(0x0)
 함수가 성공했습니다.
TBS_E_BAD_PARAMETER
2150121474(0x80284002)
 하나 이상의 매개 변수 값이 잘못되었습니다.
TBS_E_INTERNAL_ERROR
2150121473(0x80284001)
 내부 소프트웨어 오류가 발생했습니다.
TBS_E_INVALID_CONTEXT_PARAM
2150121479(0x80284007)
 TBS 컨텍스트를 만들려고 할 때 유효하지 않은 컨텍스트 매개 변수가 전달되었습니다.
TBS_E_INVALID_OUTPUT_POINTER
2150121475(0x80284003)
 지정된 출력 포인터가 잘못되었습니다.
TBS_E_SERVICE_DISABLED
2150121488(0x80284010)
 TBS 서비스가 비활성화되었습니다.
TBS_E_SERVICE_NOT_RUNNING
2150121480(0x80284008)
 TBS 서비스가 실행되고 있지 않아 시작할 수 없습니다.
TBS_E_SERVICE_START_PENDING
2150121483(0x8028400B)
 TBS 서비스가 시작되었지만 아직 실행되고 있지 않습니다.
TBS_E_TOO_MANY_TBS_CONTEXTS
2150121481(0x80284009)
 열려 있는 컨텍스트가 너무 많기 때문에 새 컨텍스트를 만들 수 없습니다.
TBS_E_TPM_NOT_FOUND
2150121487(0x8028400F)
 호환되는 TPM(신뢰할 수 있는 플랫폼 모듈) 보안 디바이스는 이 컴퓨터에서 찾을 수 없습니다.

설명

버전 필드가 TPM_VERSION_12 설정된 상태에서 TBS_CONTEXT_PARAMS 구조를 제공할 수 있습니다. 버전 2.0 TPM과 상호 작용하는 애플리케이션은 버전 필드가 TPM_VERSION_20 설정된 TBS_CONTEXT_PARAMS2 구조에 대한 포인터를 전달합니다. 예약 필드를 0으로 설정하고 includeTPm20 필드를 1로 설정합니다. 애플리케이션이 버전 1.2 TPM과 상호 작용할 준비가 된 경우(시스템에 버전 2.0 TPM이 없는 경우) includeTpm12 필드를 1 로 설정합니다.

시스템에 TPM이 없거나 TPM 버전이 호출자가 요청한 것과 일치하지 않으면 Tbsi_Context_Create TBS_E_TPM_NOT_FOUND(0x8028400) 오류 코드를 반환합니다. 애플리케이션 프로그램은 두 버전 모두에 대해 검사 TPM과 상호 작용할 수 있어야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tbs.h
라이브러리 Tbs.lib
DLL Tbs.dll