Share via

Metodo IMMDevice::OpenPropertyStore (mmdeviceapi.h)

  • Articolo

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
E_INVALIDARG
 Il parametro stgmAccess non è una modalità di accesso valida.
E_POINTER
 Il parametro ppProperties è NULL.
E_OUTOFMEMORY
 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

Vedi anche

Interfaccia IMMDevice