Metodo IWMDMDevice3::SetProperty (mswmdm.h)

Articolo
02/29/2024

Il metodo SetProperty imposta una proprietà del dispositivo specifica, se scrivibile.

Sintassi

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

Parametri

[in] pwszPropName

Carattere wide, nome stringa con terminazione Null della proprietà da impostare. In questo modo viene sovrascritta qualsiasi proprietà esistente con lo stesso nome. Dopo che l'applicazione ha effettuato questa chiamata, dovrebbe liberare qualsiasi memoria dinamica usando PropVariantClear. In Costanti metadati viene fornito un elenco di costanti dei nomi di proprietà standard.

[in] pValue

Valore della proprietà impostata.

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

Questo metodo imposta la proprietà del dispositivo specificata. Per ottenere l'elenco delle proprietà del dispositivo supportate, il client deve eseguire una query sul metodo IWMDMDevice3::GetProperty per la proprietà g_wszWMDMSupportedDeviceProperties .

Per l'elenco dei nomi delle proprietà del dispositivo, vedere Costanti dei metadati.

Questo metodo è simile al metodo SetMetadata per le risorse di archiviazione, ma questo metodo può impostare una sola proprietà contemporaneamente.

Non tutte le proprietà del dispositivo possono essere impostate.