IKnownFolderManager::UnregisterFolder-Methode (shobjidl_core.h)

  • Artikel

Entfernen Sie einen bekannten Ordner aus der Registrierung, wodurch er dem bekannten Ordnersystem unbekannt ist. Mit dieser Methode wird der Ordner selbst nicht entfernt.

Syntax

HRESULT UnregisterFolder(
  [in] REFKNOWNFOLDERID rfid
);

Parameter

[in] rfid

Typ: REFKNOWNFOLDERID

GUID oder KNOWNFOLDERID , die den bekannten Ordner darstellt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode Beschreibung
E_INVALIDARG
 Dieser Wert kann unter anderem angeben, dass der rfid-Parameter auf eine KNOWNFOLDERID verweist, die nicht im System vorhanden ist. Nicht alle KNOWNFOLDERID-Werte sind auf allen Systemen vorhanden. Verwenden Sie IKnownFolderManager::GetFolderIds , um den Satz von KNOWNFOLDERID-Werten abzurufen, die dem aktuellen System bekannt sind.

Hinweise

Hinweis Diese Methode aktualisiert HKEY_LOCAL_MACHINE und muss im Kontext eines Administrators ausgeführt werden. Setupprogramme benötigen Administratorrechte, um die Registrierung eines bekannten Ordners zu registrieren oder aufzuheben.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll

Weitere Informationen

IKnownFolderManager

IKnownFolderManager::RegisterFolder

Bekannte Ordner (Beispiel)