LoadEnclaveData 関数 (enclaveapi.h)

CreateEnclave を呼び出して作成した初期化されていないエンクレーブにデータを読み込みます。

構文

BOOL LoadEnclaveData(
  [in]            HANDLE  hProcess,
  [in]            LPVOID  lpAddress,
  [in]            LPCVOID lpBuffer,
  [in]            SIZE_T  nSize,
  [in]            DWORD   flProtect,
  [in]            LPCVOID lpPageInformation,
  [in]            DWORD   dwInfoLength,
  [out]           PSIZE_T lpNumberOfBytesWritten,
  [out, optional] LPDWORD lpEnclaveError
);

パラメーター

[in] hProcess

エンクレーブが作成されたプロセスへのハンドル。

[in] lpAddress

データを読み込むエンクレーブ内のアドレス。

[in] lpBuffer

エンクレーブに読み込むデータへのポインター。

[in] nSize

エンクレーブに読み込むデータのサイズ (バイト単位)。 この値は、ページ サイズの整数の倍数である必要があります。

[in] flProtect

エンクレーブに追加するページに使用するメモリ保護。 メモリ保護値の一覧については、「 メモリ保護定数」を参照してください。 この値には、次の定数を含めてはいけません。

• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE
• PAGE_NOACCESS

この値には、次の表で説明するエンクレーブ固有の定数を含めることができます。

[in] lpPageInformation

エンクレーブに追加するページを記述する情報へのポインター。 lpPageInformation パラメーターは使用されません。

[in] dwInfoLength

lpPageInformation パラメーターが指す構造体の長さ (バイト単位)。 この値は 0 にする必要があります。

[out] lpNumberOfBytesWritten

LoadEnclaveData がエンクレーブにコピーしたバイト数を受け取る変数へのポインター。

[out, optional] lpEnclaveError

アーキテクチャ固有のエンクレーブ エラー コードを受け取る変数への省略可能なポインター。 lpEnclaveError パラメーターは使用されません。

戻り値

すべてのデータがエンクレーブに正常に読み込まれた場合、戻り値は 0 以外になります。 それ以外の場合、戻り値は 0 です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

一般的なエラー コードの一覧については、「 システム エラー コード」を参照してください。 この関数には、次のエラー コードも適用されます。

注釈

エンクレーブにデータを読み込んでからエンクレーブを初期化するには、 InitializeEnclave を呼び出します。

LoadEnclaveData は、ENCLAVE_TYPE_SGXとENCLAVE_TYPE_SGX2エンクレーブの種類を持つエンクレーブのみをサポートしています。

要件

こちらもご覧ください

エンクレーブ関数

CreateEnclave

InitializeEnclave

メモリ保護定数