Metodo IKnownFolderManager::Redirect (shobjidl_core.h)

Articolo
03/05/2024

Reindirizza le richieste di cartelle per cartelle comuni e per utente.

Sintassi

HRESULT Redirect(
  [in]           REFKNOWNFOLDERID    rfid,
  [in, optional] HWND                hwnd,
  [in]           KF_REDIRECT_FLAGS   flags,
  [in, optional] LPCWSTR             pszTargetPath,
  [in]           UINT                cFolders,
  [in]           const KNOWNFOLDERID *pExclusion,
  [out]          LPWSTR              *ppszError
);

Parametri

[in] rfid

Tipo: REFKNOWNFOLDERID

Riferimento alla cartella KNOWNFOLDERID della cartella da reindirizzare.

[in, optional] hwnd

Tipo: HWND

Handle della finestra padre usata per visualizzare le finestre di dialogo dell'interfaccia utente dello stato del motore di copia quando KF_REDIRECT_WITH_UI viene passato nel parametro flag . Se non è necessaria alcuna finestra di dialogo di stato, questo valore può essere NULL.

[in] flags

Tipo: KF_REDIRECT_FLAGS

Opzioni di KF_REDIRECT_FLAGS per il reindirizzamento.

[in, optional] pszTargetPath

Tipo: LPCWSTR

Puntatore al nuovo percorso della cartella. Si tratta di una stringa Unicode con terminazione null. Questo valore può essere NULL.

[in] cFolders

Tipo: UINT

Numero di valori KNOWNFOLDERID nella matrice in pExclusion.

[in] pExclusion

Tipo: NOTOFOLDERID const*

Puntatore a una matrice di valori KNOWNFOLDERID che fanno riferimento a sottocartelle di rfid che devono essere esclusi dal reindirizzamento. Se non vengono escluse sottocartelle, questo valore può essere NULL.

[out] ppszError

Tipo: LPWSTR*

Quando questo metodo restituisce, contiene l'indirizzo di un puntatore a una stringa Unicode con terminazione null contenente un messaggio di errore se è stato generato. Questo valore può essere NULL.

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 per il sistema corrente.

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)

Vedi anche

IKnownFolderManager

Esempio di cartelle note

Share via