funzione CM_Set_Class_Registry_PropertyW (cfgmgr32.h)
La funzione CM_Set_Class_Registry_Property imposta o elimina una proprietà di una classe di installazione del dispositivo.
Sintassi
CMAPI CONFIGRET CM_Set_Class_Registry_PropertyW(
[in] LPGUID ClassGuid,
[in] ULONG ulProperty,
[in, optional] PCVOID Buffer,
[in] ULONG ulLength,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parametri
[in] ClassGuid
Puntatore al GUID che rappresenta la classe di installazione del dispositivo per cui impostare una proprietà.
[in] ulProperty
Valore di tipo ULONG che identifica la proprietà da impostare. Questo valore deve essere uno dei valori CM_CRP_Xxx descritti per il parametro ulProperty della funzione CM_Get_Class_Registry_Property .
[in, optional] Buffer
Puntatore a un buffer contenente i dati delle proprietà. Questo parametro è facoltativo e può essere impostato su NULL. Per altre informazioni sull'impostazione di questo parametro e sul parametro ulLength corrispondente, vedere la sezione Osservazioni seguente.
[in] ulLength
Valore di tipo ULONG che specifica le dimensioni, in byte, dei dati delle proprietà.
[in] ulFlags
Riservato esclusivamente per uso interno. Deve essere impostato su zero.
[in, optional] hMachine
Handle a un computer remoto in cui impostare la proprietà della classe di configurazione del dispositivo specificata. Questo parametro è facoltativo e, Se impostato su NULL, la proprietà è impostata nel computer locale.
Valore restituito
Se l'operazione ha esito positivo, CM_Set_Class_Registry_Property restituisce CR_SUCCESS. In caso contrario, la funzione restituisce uno degli altri codici di stato CR_Xxx definiti in Cfgmgr32.h.
Commenti
Se buffer è NULL, ulLength deve essere impostato su zero.
Se ulLength è impostato su zero, la funzione elimina la proprietà.
Se buffer non è impostato su NULL e ulLength non è impostato su zero, il valore specificato deve essere la dimensione corretta per il tipo di dati REG_Xxx per la proprietà specificata in ulProperty.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
Piattaforma di destinazione | Universale |
Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
Libreria | Cfgmgr32.lib |
Vedi anche
CM_Get_Class_Registry_Property