Recuperando dados do Registro

Para recuperar dados do Registro, um aplicativo normalmente enumera as subchaves de uma chave até encontrar uma determinada e, em seguida, recupera dados do valor ou dos valores associados a ela. Um aplicativo pode chamar a função RegEnumKeyEx para enumerar as subchaves de uma determinada chave.

Para recuperar dados detalhados sobre uma subchave específica, um aplicativo pode chamar a função RegQueryInfoKey . A função RegGetKeySecurity recupera uma cópia do descritor de segurança que protege uma chave.

Um aplicativo pode usar a função RegEnumValue para enumerar os valores de uma determinada chave e a função RegQueryValueEx para recuperar um valor específico para uma chave. Um aplicativo normalmente chama RegEnumValue para determinar os nomes de valor e RegQueryValueEx para recuperar os dados dos nomes.

A função RegQueryMultipleValues recupera o tipo e os dados de uma lista de nomes de valor associados a uma chave do Registro aberta. Essa função é útil para provedores de chave dinâmica porque garante a consistência dos dados recuperando vários valores em uma operação atômica.

Como outros aplicativos podem alterar os dados em um valor do Registro entre a hora em que seu aplicativo pode ler um valor e usá-lo, talvez seja necessário garantir que seu aplicativo tenha os dados mais recentes. Você pode usar a função RegNotifyChangeKeyValue para notificar o thread de chamada quando houver alterações nos atributos ou no conteúdo de uma chave do Registro ou se a chave for excluída. A função sinaliza um objeto de evento para notificar o chamador. Se o thread que chama RegNotifyChangeKeyValue for encerrado, o evento será sinalizado e o monitoramento da chave do Registro será interrompido.

Você pode controlar ou especificar quais alterações devem ser relatadas por meio do uso de um filtro ou sinalizador de notificação. Normalmente, as alterações são relatadas sinalizando um evento que você especifica para a função. Observe que a função RegNotifyChangeKeyValue não funciona com identificadores remotos.

Para monitorar as operações do Registro mais detalhadamente, consulte Registro.