Metodo IMDSPStorageGlobals::GetCapabilities (mswmdm.h)
Il metodo GetCapabilities recupera le funzionalità del supporto di archiviazione a cui è associata un'istanza di questa interfaccia.
Sintassi
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Parametri
[out] pdwCapabilities
Puntatore a un DWORD contenente le funzionalità del supporto di archiviazione.
I flag seguenti possono essere restituiti nel parametro pdwCapabilities .
| Flag | Descrizione |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | Il supporto supporta le cartelle nella radice dell'archiviazione. |
| WMDM_STORAGECAP_FILESINROOT | Il supporto supporta i file nella radice dell'archiviazione. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | Il supporto supporta le cartelle nelle cartelle. |
| WMDM_STORAGECAP_FILESINFOLDERS | Il supporto supporta i file nelle cartelle. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | Esiste un limite di conteggio arbitrario per il numero di cartelle consentite per ogni forma di supporto della cartella da parte del supporto medio. |
| WMDM_STORAGECAP_FILELIMITEXISTS | Esiste un limite di conteggio arbitrario per il numero di file consentiti per ogni forma di supporto del file da parte del supporto medio. |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | Impossibile inizializzare il supporto. Per impostazione predefinita, l'archiviazione di primo livello può essere inizializzata. |
Per le implementazioni di dispositivi protette, è possibile restituire anche i flag seguenti che descrivono le funzionalità dei diritti del supporto.
| Flag | Descrizione |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | Il supporto supporta la limitazione del numero di riproduzione per il contenuto. |
| WMDM_RIGHTS_EXPIRATIONDATE | Il supporto supporta il rilevamento della data di scadenza per il contenuto. |
| WMDM_RIGHTS_FREESERIALIDS | Il supporto supporta un identificatore seriale libero per il file. |
| WMDM_RIGHTS_GROUPID | Il supporto supporta un identificatore di gruppo per il file. |
| WMDM_RIGHTS_NAMEDSERIALIDS | Il supporto supporta un identificatore seriale denominato per il file. |
Valore restituito
Il metodo restituisce un 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
Commenti
Tenta di eseguire operazioni non supportate nel supporto di archiviazione con l'interfaccia IMDSPObject restituisce un codice di errore. Il metodo GetCapabilities può essere chiamato per determinare se un'operazione può essere eseguita correttamente in circostanze normali.
Se il flag WMDM_STORAGECAP_FILELIMITEXISTS o il flag di WMDM_STORAGECAP_FOLDERLIMITEXISTS è true, esistono limiti arbitrari sul numero di file o cartelle che possono essere creati. Le operazioni tramite l'interfaccia IMDSPObject che superano questi limiti avranno esito negativo.
Questo metodo deve essere implementato. Non deve restituire WMDM_E_NOTSUPPORTED o E_NOTIMPL. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |