Metodo IWMDMStorageControl::Rename (mswmdm.h)

Articolo
08/25/2023

Il metodo Rename rinomina la risorsa di archiviazione corrente.

Sintassi

HRESULT Rename(
  [in] UINT          fuMode,
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

Parametri

[in] fuMode

Modalità di elaborazione utilizzata per l'operazione Rinomina . Specificare esattamente una delle due modalità seguenti. Se vengono specificate entrambe le modalità, viene utilizzata la modalità di blocco.

Mode	Descrizione
WMDM_MODE_BLOCK	L'operazione viene eseguita usando l'elaborazione in modalità blocco. La chiamata non verrà restituita fino al termine dell'operazione.
WMDM_MODE_THREAD	L'operazione viene eseguita usando l'elaborazione in modalità thread. La chiamata restituisce immediatamente e l'operazione viene eseguita in un thread in background.

[in] pwszNewName

Puntatore a una stringa con terminazione Null a caratteri wide che specifica il nuovo nome.

[in] pProgress

Puntatore facoltativo a un'interfaccia IWMDMProgress implementata dall'applicazione per tenere traccia dello stato di avanzamento dell'azione.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Se viene specificato il flag WMDM_MODE_THREAD, è necessario ottenere lo stato di completamento chiamando IWMDMProgress2::End2 o IWMDMProgress3::End3. Questi metodi garantiranno il completamento dell'operazione e restituiranno anche un HRESULT con informazioni sull'esito positivo o negativo.

Se un'applicazione usa WMDM_MODE_THREAD e passa un parametro pProgress diverso da null, l'applicazione deve assicurarsi che l'oggetto a cui appartiene pProgress non venga eliminato definitivamente fino al completamento dell'operazione di lettura, perché Windows Media Gestione dispositivi invierà notifiche di stato a questo oggetto. Questo oggetto può essere eliminato definitivamente solo dopo la ricezione di una notifica End. In caso contrario, si verificheranno violazioni dell'accesso.