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 リターン コードが返されます。

リターン コード/値 Description
TBS_SUCCESS
0 (0x0)
 関数は成功しました。
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
 1 つ以上のパラメーター値が無効です。
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) セキュリティ デバイスがこのコンピューターに見つかりません。

注釈

TBS_CONTEXT_PARAMS構造を指定し、バージョン フィールドをTPM_VERSION_12に設定できます。 バージョン 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
Library Tbs.lib
[DLL] Tbs.dll