Método IKnownFolderManager::UnregisterFolder (shobjidl_core.h)
Remova uma pasta conhecida do registro, o que a torna desconhecida para o sistema de pastas conhecido. Esse método não remove a pasta em si.
Sintaxe
HRESULT UnregisterFolder(
[in] REFKNOWNFOLDERID rfid
);
Parâmetros
[in] rfid
Tipo: REFKNOWNFOLDERID
GUID ou KNOWNFOLDERID que representa a pasta conhecida.
Retornar valor
Tipo: HRESULT
Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:
Código de retorno | Descrição |
---|---|
|
Entre outras coisas, esse valor pode indicar que o parâmetro rfid faz referência a um KNOWNFOLDERID que não está presente no sistema. Nem todos os valores KNOWNFOLDERID estão presentes em todos os sistemas. Use IKnownFolderManager::GetFolderIds para recuperar o conjunto de valores KNOWNFOLDERID conhecidos pelo sistema atual. |
Comentários
Nota Esse método atualiza HKEY_LOCAL_MACHINE e precisa ser executado no contexto de um administrador. Os programas de instalação precisam de privilégios de administrador para registrar ou cancelar o registro de uma pasta conhecida.
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 | shobjidl_core.h (inclua Shobjidl.h) |
DLL | Shell32.dll |