Compartilhar via

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
E_INVALIDARG
 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

Confira também

IKnownFolderManager

IKnownFolderManager::RegisterFolder

Exemplo de pastas conhecidas

  • Last updated on