Função LoadEnclaveData (enclaveapi.h)

Carrega dados em um enclave não inicializado que você criou chamando CreateEnclave.

Sintaxe

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
);

Parâmetros

[in] hProcess

Um identificador para o processo para o qual o enclave foi criado.

[in] lpAddress

O endereço no enclave em que você deseja carregar os dados.

[in] lpBuffer

Um ponteiro para os dados que você deseja carregar no enclave.

[in] nSize

O tamanho dos dados que você deseja carregar no enclave, em bytes. Esse valor deve ser um número inteiro múltiplo do tamanho da página.

[in] flProtect

A proteção de memória a ser usada para as páginas que você deseja adicionar ao enclave. Para obter uma lista de valores de proteção de memória, consulte constantes de proteção de memória. Esse valor não deve incluir as seguintes constantes:

• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE
• PAGE_NOACCESS

Esse valor pode incluir as constantes específicas do enclave que a tabela a seguir descreve:

[in] lpPageInformation

Um ponteiro para informações que descrevem as páginas que você deseja adicionar ao enclave. O parâmetro lpPageInformation não é usado.

[in] dwInfoLength

O comprimento da estrutura para a qual o parâmetro lpPageInformation aponta, em bytes. Esse valor precisa ser 0.

[out] lpNumberOfBytesWritten

Um ponteiro para uma variável que recebe o número de bytes que LoadEnclaveData copiou para o enclave.

[out, optional] lpEnclaveError

Um ponteiro opcional para uma variável que recebe um código de erro de enclave específico da arquitetura. O parâmetro lpEnclaveError não é usado.

Retornar valor

Se todos os dados forem carregados no enclave com êxito, o valor retornado será diferente de zero. Caso contrário, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Para obter uma lista de códigos de erro comuns, consulte Códigos de erro do sistema. Os códigos de erro a seguir também se aplicam a essa função.

Comentários

Para inicializar o enclave depois de carregar dados no enclave, chame InitializeEnclave.

LoadEnclaveData só tem suporte para enclaves que têm os tipos de enclave ENCLAVE_TYPE_SGX e ENCLAVE_TYPE_SGX2 .

Requisitos

Confira também

Funções de enclave

CreateEnclave

InitializeEnclave

Constantes de proteção de memória