Metodo IKnownFolderManager::UnregisterFolder (shobjidl_core.h)

Rimuovere una cartella nota dal Registro di sistema, che lo rende sconosciuto al sistema di cartelle noto. Questo metodo non rimuove la cartella stessa.

Sintassi

HRESULT UnregisterFolder(
  [in] REFKNOWNFOLDERID rfid
);

Parametri

[in] rfid

Tipo: REFKNOWNFOLDERID

GUID o KNOWNFOLDERID che rappresenta la cartella nota.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Codice restituito	Descrizione
E_INVALIDARG	Tra le altre cose, questo valore può indicare che il parametro rfid fa riferimento a un KNOWNFOLDERID che non è presente nel sistema. Non tutti i valori KNOWNFOLDERID sono presenti in tutti i sistemi. Usare IKnownFolderManager::GetFolderIds per recuperare il set di valori KNOWNFOLDERID noti al sistema corrente.

Commenti

Nota Questo metodo aggiorna HKEY_LOCAL_MACHINE e deve essere eseguito nel contesto di un amministratore. I programmi di installazione richiedono privilegi di amministratore per registrare o annullare la registrazione di una cartella nota.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll

Vedi anche

IKnownFolderManager

IKnownFolderManager::RegisterFolder

Esempio di cartelle note