IKnownFolderManager::UnregisterFolder-Methode (shobjidl_core.h)
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 |
|---|---|
|
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 |