Recuperando dados do Registro

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

Para recuperar dados detalhados sobre uma subchave específica, um aplicativo pode chamar a funçãoRegQueryInfoKey. A funçãoRegGetKeySecurity 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 função RegQueryValueEx para recuperar um valor específico para uma chave. Um aplicativo normalmente chama RegEnumValue para determinar os nomes de valor e, em seguida, RegQueryValueEx para recuperar os dados para os nomes.

A funçãoRegQueryMultipleValues recupera o tipo e os dados de uma lista de nomes de valor associados a uma chave do Registro aberta. Esta função é útil para provedores de chaves dinâmicas 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 o momento 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çãoRegNotifyChangeKeyValue 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 a fila de execução que chama RegNotifyChangeKeyValue entra em encerramento, o evento é sinalizado e o monitoramento da chave do registro é 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 monitorizar as operações do Registro com mais detalhes, consulte Registro.