다음을 통해 공유

Tbsip_Submit_Command 함수(tbs.h)

  • 아티클

처리를 위해 TPM(신뢰할 수 있는 플랫폼 모듈) 명령을 TBS(TPM 기본 서비스)에 제출합니다.

구문

TBS_RESULT Tbsip_Submit_Command(
  [in]      TBS_HCONTEXT         hContext,
  [in]      TBS_COMMAND_LOCALITY Locality,
  [in]      TBS_COMMAND_PRIORITY Priority,
  [in]      PCBYTE               pabCommand,
  [in]      UINT32               cbCommand,
  [out]     PBYTE                pabResult,
  [in, out] PUINT32              pcbResult
);

매개 변수

[in] hContext

명령을 제출하는 컨텍스트의 핸들입니다.

[in] Locality

TPM 명령에 대한 지역성을 설정하는 데 사용됩니다. 다음 값 중 하나여야 합니다.

값 의미
TBS_COMMAND_LOCALITY_ZERO
0(0x0)
 지역성 0. 현재 지원되는 유일한 지역입니다.
TBS_COMMAND_LOCALITY_ONE
1(0x1)
 지역성 1.
TBS_COMMAND_LOCALITY_TWO
2(0x2)
 지역성 2.
TBS_COMMAND_LOCALITY_THREE
3(0x3)
 지역성 3.
TBS_COMMAND_LOCALITY_FOUR
4(0x4)
 지역 4.

[in] Priority

명령에 있어야 하는 우선 순위 수준입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
TBS_COMMAND_PRIORITY_LOW
100(0x64)
 우선 순위가 낮은 애플리케이션 사용에 사용됩니다.
TBS_COMMAND_PRIORITY_NORMAL
200(0xC8)
 일반적인 우선 순위 애플리케이션 사용에 사용됩니다.
TBS_COMMAND_PRIORITY_SYSTEM
400 (0x190)
 TPM에 액세스하는 시스템 작업에 사용됩니다.
TBS_COMMAND_PRIORITY_HIGH
300 (0x12C)
 우선 순위가 높은 애플리케이션 사용에 사용됩니다.
TBS_COMMAND_PRIORITY_MAX
2147483648(0x80000000)
 전원 관리 시스템에서 시작된 작업에 사용됩니다.

[in] pabCommand

처리할 TPM 명령이 포함된 버퍼에 대한 포인터입니다.

[in] cbCommand

명령의 길이(바이트)입니다.

[out] pabResult

TPM 명령의 결과를 수신할 버퍼에 대한 포인터입니다. 이 버퍼는 pabCommand와 동일할 수 있습니다.

[in, out] pcbResult

입력 시 결과 버퍼의 크기(바이트)를 지정하는 정수입니다. 이 값은 submit 명령이 반환되면 설정됩니다. 제공된 버퍼가 너무 작으면 출력 시 이 매개 변수는 결과에 필요한 크기(바이트)로 설정됩니다.

반환 값

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

명령을 성공적으로 제출하고 TPM에서 계속 실패할 수 있습니다. 이 경우 오류 코드는 결과 버퍼에서 표준 TPM 오류로 반환됩니다.

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

반환 코드/값 설명
TBS_SUCCESS
0(0x0)
 함수가 성공했습니다.
TBS_E_BAD_PARAMETER
2150121474(0x80284002)
 하나 이상의 매개 변수 값이 잘못되었습니다.
TBS_E_BUFFER_TOO_LARGE
2150121486(0x8028400E)
 입력 또는 출력 버퍼가 너무 큽
TBS_E_INTERNAL_ERROR
2150121473(0x80284001)
 내부 소프트웨어 오류가 발생했습니다.
TBS_E_INSUFFICIENT_BUFFER
2150121477(0x80284005)
 지정된 출력 버퍼가 너무 작습니다.
TBS_E_INVALID_CONTEXT
2150121476(0x80284004)
 지정된 컨텍스트 핸들이 유효한 컨텍스트를 참조하지 않습니다.
TBS_E_INVALID_OUTPUT_POINTER
2150121475(0x80284003)
 지정된 출력 포인터가 잘못되었습니다.
TBS_E_IOERROR
2150121478(0x80284006)
 TPM과 통신하는 동안 오류가 발생했습니다.

요구 사항

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