CRegKey::SetValue
Chamar esse método para armazenar dados em um campo de valor especificado de m_hKey. As versões anteriores de este método não são suportadas e marcadas como ATL_DEPRECATED.
LONG SetValue(
LPCTSTR pszValueName,
DWORD dwType,
const void* pValue,
ULONG nBytes
) throw( );
static LONG WINAPI SetValue(
HKEY hKeyParent,
LPCTSTR lpszKeyName,
LPCTSTR lpszValue,
LPCTSTR lpszValueName = NULL);
ATL_DEPRECATED LONG SetValue(
DWORD dwValue,
LPCTSTR lpszValueName
);
ATL_DEPRECATED LONG SetValue(
LPCTSTR lpszValue,
LPCTSTR lpszValueName = NULL,
bool bMulti = false,
int nValueLen = -1
);
Parâmetros
pszValueName
Ponteiro para uma cadeia de caracteres que contém o nome do valor a ser definido. Se um valor com esse nome não está mais atual da chave, o método adiciona à chave. Se pszValueName NULL é ou uma cadeia de caracteres vazia, "", o método define o tipo e os dados para a chave sem nome ou o valor padrão.dwType
Especifica um código que indica o tipo de dados apontados pelo parâmetro de pValue .pValue
Ponteiro para um buffer que contém os dados a serem armazenados com o nome especificado de valor.nBytes
Especifica o tamanho, em bytes, de informações apontada pelo parâmetro de pValue . Se os dados são do tipo REG_SZ, REG_EXPAND_SZ, ou REG_MULTI_SZ, nBytes deve incluir o tamanho do caractere de terminação zero.hKeyParent
O identificador de uma chave aberta.lpszKeyName
Especifica o nome de uma chave a ser criada ou aberto. Este nome deve ser uma subchave de hKeyParent.lpszValue
Especifica os dados a serem armazenados. Este parâmetro deve ser não-nulo.lpszValueName
Especifica o campo de valor a ser definido. Se um campo de valor com esse nome já existe na chave, é adicionada.dwValue
Especifica os dados a serem armazenados.bMulti
Se falso, indica que a cadeia de caracteres é do tipo REG_SZ. Se verdadeiro, indica que a cadeia de caracteres é multistring de tipo REG_MULTI_SZ.nValueLen
Se bMulti é verdadeiro, nValueLen é o comprimento da cadeia de caracteres de lpszValue em caracteres. Se bMulti é falso, um valor de -1 indica que o método calculará o comprimento automaticamente.
Valor de retorno
Se com êxito, retorna ERROR_SUCCESS; caso contrário, um código de erro diferente de zero definido em. WINERROR.H.
Comentários
As duas versões originais de SetValue são marcadas como ATL_DEPRECATED e não devem ser usados. O compilador emitirá um aviso se esses formulários são usados.
o terceiro método chama RegSetValueEx.
Requisitos
Cabeçalho: atlbase.h