ReadRegistryFromOEM

9/8/2008

Esta função lê um arquivo Registro para memória RAM de armazenamento persistente conforme definido pela OEM. Essa função é que pode ser chamado do modo kernel somente.

Syntax

DWORD ReadRegistryFromOEM(
  DWORD dwFlags, 
  LPBYTE lpData, 
  DWORD cbData 
);

Parameters

• dwFlags
  [no] Leia as opções especificadas pelo OS.

  REG_READ_BYTES_START indica leitura deve iniciar a partir do início do arquivo de Registro.

• lpData
  [no] Ponteiro para uma reserva alocado pelo OS.

  Você deve carregar a reserva com bytes Registro up to um máximo de cbData.

• cbData
  [no] Tamanho, em bytes, da reserva para o qual lpData Pontos.

  Esse valor é passado pela OS.

Return Value

Retorna o número de bytes adicionados à lpData.

Se 0 for retornado, o fim de arquivo (EOF) foi alcançado.

Se-1 é retornado, em seguida, ler da sua função funcionalidade tem falha e o OS deve carregar o Registro usar como padrão.

Remarks

Expõe o OS um pReadRegistryFromOEM variável global que está disponível na OAL. Para suporte Restaurando o Registro de armazenamento persistente, implementar a ReadRegistryFromOEM função e atribuir o endereço da função para pReadRegistryFromOEM.

Durante inicialização Registro, o OS verifica para um válido pReadRegistryFromOEM. Se ele for válido, o OS continua a chamar pReadRegistryFromOEM Para recuperar bytes até pReadRegistryFromOEM Retorna 0, para fim de arquivo, ou -1.

Se houver problemas graves ou condições sob as quais não é possível continuar a inicialização, você poderá implementar esta função para que ele não retorna. De exemplo, você pode informar o usuário do problema e possíveis soluções.

Porque o OS é um segmento único neste estágio da inicialização, nenhuma outra atividade OS ocorre, a menos que essa função retorna execução.

O WriteRegistryToOEM função e ReadRegistryFromOEM Mecanismo só é com suporte, Registro Store-Based o objeto. Para salvar e restaurar dados no Registro Hive-based, consulte o RegSaveKey e RegReplaceKey funções.

O arquivo de dados salvo pela função RegCopyFile Não podem ser importados diretamente pelo ReadRegistryFromOEM. Uso RegCopyFile Para salvar os dados a serem restaurados pela função RegRestoreFile, ou use WriteRegistryToOEM Para salvar os dados a ser importado pelo ReadRegistryFromOEM.

Requirements

Header	pkfuncs.h
Library	Nk.lib
Windows Embedded CE	Windows CE 2.10 and later

See Also

Reference

pReadRegistryFromOEM
WriteRegistryToOEM

Other Resources

Kernel Mode APIs
RegSaveKey
RegReplaceKey
RegCopyFile
RegRestoreFile
Persisting Data with the RAM-Based Registry