RegistryGetDWORD

9/8/2008

Esta função lê valores Registro REG_DWORD.

Syntax

HRESULT WINAPI RegistryGetDWORD( 
  HKEY hKey,
  LPCTSTR pszSubKey,
  LPCTSTR pszValueName,
  DWORD* pdwData
);

Parameters

• hKey
  [no] Identificador para o aberto chave ou um valor predefinido raiz.

• pszSubKey
  [no] Chave onde o valor é armazenado. Se esse valor é NULL, em seguida, pszValueName é considerado em HKEY.

• pszValueName
  [no] Chamado valor para recuperar. Se esse valor é NULL, a função recupera o valor usar como padrão.

• pdwData
  [out] Um ponteiro para a reserva que receberá os dados.

Return Value

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
S_OK	Dados são copiados para a reserva.
E_INVALIDARG	Inválido HKEY Ou pdwData.
E_DATATYPE_MISMATCH	O valor não é tipo REG_DWORD.
Um valor de erro retornado pelo RegOpenKey Ou RegQueryValueEx.	Valor de erro ajustada como um FACILITY_WIN32 HRESULT.

Remarks

Êxito indica que o valor é copiado para a reserva apontada pelo pdwData. Falha não causar qualquer alteração.

O snapi.h arquivo de cabeçalho contém definições para as chaves Registro, caminhos, valores e bitmasks para todas as notificações de de base que são fornecidas pelo sistema.

Se a chave apontado pelo HKEY e pszSubkey Não existe, o função falhar.

Exemplo de código

O seguinte exemplo de código demonstra como usar RegistryGetDWORD.

Observação

Para fazer o seguinte exemplo de código mais fácil de ler, verificação de segurança e manipulação de erro não estão incluídos.Esta exemplo de código não deve ser usado em uma configuração versão a menos que ele foi modificado para incluí-las.

DWORD GetNumberOfBlueToothConnections()
{
    DWORD cBluetoothConnections = 0;
    HRESULT hr;
    hr = RegistryGetDWORD(SN_CONNECTIONSBLUETOOTHCOUNT_ROOT, 
                          SN_CONNECTIONSBLUETOOTHCOUNT_PATH, 
                          SN_CONNECTIONSBLUETOOTHCOUNT_VALUE, 
                          &cBluetoothConnections);
    if (SUCCEEDED(hr))
        return cBluetoothConnections;
    else
        return 0;

Requirements

Header	regext.h
Library	aygshell.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

State and Notifications Broker Functions
State and Notifications Broker Reference

Concepts

Using the State and Notifications Broker in Native Code

Other Resources

State and Notifications Broker