funzione CM_Set_Class_Registry_PropertyA (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_PropertyA(
  [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

Vedi anche

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty