Compartilhar via


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

Consulte também

Referência

Classe de CRegKey

CRegKey::SetKeyValue

CRegKey::QueryValue

Registry Value Types