Condividi tramite


Metodo IMDSPDevice2::GetStorage (mswmdm.h)

Il metodo GetStorage consente di passare direttamente a una risorsa di archiviazione in base al nome anziché enumerare tutte le risorse di archiviazione per trovarla.

Sintassi

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

Parametri

[in] pszStorageName

Puntatore a una stringa con terminazione Null contenente il nome della risorsa di archiviazione da trovare.

[out] ppStorage

Puntatore all'oggetto di archiviazione specificato dal parametro pszStorageName .

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

Il metodo GetStorage non supporta caratteri jolly. Non è ricorsivo, ovvero troverà solo le risorse di archiviazione nella radice del dispositivo.

Se questo metodo non viene implementato, deve restituire E_NOTIMPL. Non deve restituire WMDM_E_NOT_SUPPORTED o altri codici che indicano che questo metodo non è implementato. In questo modo, Windows Media Gestione dispositivi tenterà di sostituire questa funzionalità enumerando tutte le risorse di archiviazione per trovare una corrispondenza in base al nome di archiviazione passato come pszStorageName.

È consigliabile che un provider di servizi implementi questo metodo per restituire in modo efficiente un oggetto di archiviazione in base al nome.

È facoltativo. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione mswmdm.h
Libreria Mssachlp.lib

Vedi anche

Interfaccia IMDSPDevice2