Metodo IResultData2::RenameResultItem (mmc.h)
Il metodo RenameResultItem inserisce a livello di codice l'elemento del risultato specificato in modalità di ridenominazione, dopo di che l'utente può immettere manualmente il nuovo nome. Questo metodo è progettato in modo specifico per il caso in cui viene creato un elemento e deve essere inserito immediatamente in modalità di ridenominazione. L'uso di questo metodo in altri scenari, ad esempio la chiamata dopo la selezione di un elemento, non è supportato e potrebbe avere risultati imprevisti.
Sintassi
HRESULT RenameResultItem(
[in] HRESULTITEM itemID
);
Parametri
[in] itemID
Elemento risultante inserito in modalità di ridenominazione. Se applicato agli elenchi virtuali, passare l'indice dell'elemento anziché l'elemento risultato.
Valore restituito
In caso di esito positivo, il valore restituito viene S_OK; in caso contrario, il valore restituito è un codice di errore. È possibile utilizzare le macro SUCCEEDED e/o FAILED per valutare il valore restituito. Se il verbo Rename non è abilitato, questo metodo restituisce E_FAIL.
Commenti
L'elemento inserito in modalità di ridenominazione deve avere il verbo Rename abilitato affinché questo metodo abbia esito positivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |
| Libreria | Mmc.lib |
| DLL | Mmcndmgr.dll |