Metodo IMMDevice::OpenPropertyStore (mmdeviceapi.h)
Il metodo OpenPropertyStore recupera un'interfaccia nell'archivio delle proprietà del dispositivo.
Sintassi
HRESULT OpenPropertyStore(
[in] DWORD stgmAccess,
[out] IPropertyStore **ppProperties
);
Parametri
[in] stgmAccess
Modalità di accesso all'archiviazione. Questo parametro specifica se aprire l'archivio delle proprietà in modalità di lettura, modalità di scrittura o modalità di lettura/scrittura. Impostare questo parametro su una delle costanti STGM seguenti:
STGM_READ
STGM_WRITE
STGM_READWRITE
Il metodo consente a un client in esecuzione come amministratore di aprire un archivio per l'accesso in sola lettura, scrittura o lettura/scrittura. Un client che non è in esecuzione come amministratore è limitato all'accesso di sola lettura. Per altre informazioni sulle costanti STGM, vedere la documentazione di Windows SDK.
[out] ppProperties
Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IPropertyStore dell'archivio delle proprietà del dispositivo. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata OpenPropertyStore ha esito negativo, *ppProperties è NULL. Per altre informazioni su IPropertyStore, vedere la documentazione di Windows SDK.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il parametro stgmAccess non è una modalità di accesso valida. |
|
Il parametro ppProperties è NULL. |
|
Memoria insufficiente. |
Commenti
In generale, le proprietà nell'archivio delle proprietà del dispositivo sono di sola lettura per i client che non eseguono funzioni amministrative, di sistema o di servizio.
Per esempi di codice che chiamano il metodo OpenPropertyStore , vedere gli argomenti seguenti:
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mmdeviceapi.h |