Função SHRegSetValue (shlwapi.h)

Artigo
03/02/2024

Não há suporte.

Define um valor do Registro.

Use RegSetValue em seu lugar.

Sintaxe

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] LPCVOID pvData,
  [in] DWORD   cbData
);

Parâmetros

[in] hkey

Tipo: HKEY

Um identificador para a chave aberta no momento ou qualquer um dos valores predefinidos a seguir.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in] pszSubKey

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho relativo de hkey para a subchave da qual recuperar o valor. Esse parâmetro pode ser NULL ou uma cadeia de caracteres vazia; nesse caso, os dados são recuperados do local hkey .

[in] pszValue

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do valor. Esse parâmetro pode ser NULL ou uma cadeia de caracteres vazia, caso em que os dados são recuperados do valor Padrão.

[in] srrfFlags

Tipo: SRRF

Um ou mais dos sinalizadores SRRF que restringem os dados a serem definidos. Pelo menos um valor de restrição de tipo (SRRF_RT) deve ser especificado.

[in] dwType

Tipo: DWORD

O DWORD que indica o tipo de dados armazenados no valor a ser definido. Ao usar valores padrão, o dwType de entrada é o tipo do valor padrão. Para obter valores possíveis, consulte Tipos de dados do Registro. Se o sinalizador de SRRF_NOEXPAND não estiver definido, REG_EXPAND_SZ tipos serão automaticamente expandidos e retornados como REG_SZ. Se as informações de tipo não forem necessárias, esse parâmetro poderá ser NULL.

[in] pvData

Tipo: LPCVOID

Um ponteiro para um buffer que contém os dados do valor. Esse parâmetro poderá ser NULL se os dados não forem necessários.

[in] cbData

Tipo: DWORD

O tamanho do buffer de dados de origem pvData, em bytes. Esse valor só poderá ser NULL se pvData for NULL.

Retornar valor

Tipo: LONG

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro diferente de zero definido em Winerror.h caso contrário. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para recuperar uma descrição genérica do erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h (inclua Shlwapi.h)
DLL	Shlwapi.dll

Confira também

RegSetKeyValue

Compartilhar via