Função ORSetValue
Define os dados para o valor de uma chave do Registro especificada em um hive de registro offline.
Sintaxe
DWORD ORSetValue(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpValueName,
_In_ DWORD dwType,
_In_opt_ const BYTE *lpData,
_In_ DWORD cbData
);
Parâmetros
-
Manipular [in]
-
Um identificador para uma chave do Registro aberta em um hive de registro offline.
-
lpValueName [in, opcional]
-
O nome do valor a ser definido. Se um valor com esse nome ainda não estiver presente na chave, a função o adicionará à chave.
Se lpValueName for NULL ou uma cadeia de caracteres vazia, "", a função definirá o tipo e os dados para o valor não nomeado ou padrão da chave.
Para obter mais informações, consulte Limites de tamanho do elemento do Registro.
As chaves do Registro não têm valores padrão, mas podem ter um valor sem nome, que pode ser de qualquer tipo.
-
dwType [in]
-
O tipo de dados apontado pelo parâmetro lpData . Para obter uma lista dos tipos possíveis, consulte Tipos de valor do Registro.
-
lpData [in, opcional]
-
Os dados a serem armazenados.
Para tipos baseados em cadeia de caracteres, como REG_SZ, a cadeia de caracteres deve ser terminada em nulo. Para o tipo de dados REG_MULTI_SZ, a cadeia de caracteres deve ser encerrada com dois caracteres nulos.
-
cbData [in]
-
O tamanho das informações apontadas pelo parâmetro lpData , em bytes. Se os dados forem do tipo REG_SZ, REG_EXPAND_SZ ou REG_MULTI_SZ, cbData deverá incluir o tamanho do caractere nulo de terminação ou caracteres.
Valor retornado
Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor de retorno será o código de erro diferente de zero definido em Winerror.h. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.
Comentários
Os tamanhos de valor são limitados pela memória disponível. Valores longos (mais de 2048 bytes) devem ser armazenados como arquivos com os nomes de arquivo armazenados no registro. Isso ajuda o registro a ter um desempenho eficiente. Elementos de aplicativo, como ícones, bitmaps e arquivos executáveis, devem ser armazenados como arquivos e não devem ser colocados no Registro.
Requisitos
| Requisito | Valor |
|---|---|
| Redistribuível |
Biblioteca do Registro Offline do Windows versão 1.0 ou posterior |
| Cabeçalho |
|
| DLL |
|
Confira também