funzione CM_Get_Class_Registry_PropertyW (cfgmgr32.h)
La funzione CM_Get_Class_Registry_Property recupera una proprietà della classe di installazione del dispositivo .
CMAPI CONFIGRET CM_Get_Class_Registry_PropertyW(
[in] LPGUID ClassGuid,
[in] ULONG ulProperty,
[out, optional] PULONG pulRegDataType,
[out] PVOID Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
[in] ClassGuid
Puntatore al GUID che rappresenta la classe di installazione del dispositivo per cui recuperare una proprietà.
[in] ulProperty
Valore di tipo ULONG che identifica la proprietà da recuperare. Questo valore deve essere uno dei valori seguenti CM_CRP_Xxx definiti in Cfgmgr32.h:
Rappresenta un elenco di stringhe di tipo REG_MULTI_SZ, in cui ogni stringa contiene il nome di un driver di filtro di livello superiore registrato per la classe .
Rappresenta un elenco di stringhe REG_MULTI_SZ tipizzato, in cui ogni stringa contiene il nome di un driver di filtro di livello inferiore registrato per la classe .
Rappresenta un valore di tipo REG_BINARY che contiene una struttura a lunghezza variabile, auto-relativa, SECURITY_DESCRIPTOR.
Rappresenta una stringa di tipo REG_SZ che contiene un descrittore di sicurezza nel formato SDDL (Security Descriptor Definition Language).
Rappresenta un valore di tipo REG_DWORD che indica il tipo di dispositivo per la classe . Per altre informazioni, vedere Specifica dei tipi di dispositivo.
Rappresenta un valore di tipo REG_DWORD che indica se gli utenti possono ottenere l'accesso esclusivo ai dispositivi per questa classe. Il valore restituito è 1 se è consentito l'accesso esclusivo o zero in caso contrario.
Rappresenta un valore di tipo DWORD che indica le caratteristiche del dispositivo per la classe . Per un elenco dei flag di caratteristiche, vedere il parametro DeviceCharacteristics della routine IoCreateDevice.
[out, optional] pulRegDataType
Puntatore a una variabile di tipo ULONG che riceve la costante REG_Xxx che rappresenta il tipo di dati della proprietà richiesta. Le costantixxx REG_ sono definite in Winnt.h e sono descritte nel membro type della struttura KEY_VALUE_BASIC_INFORMATION. Questo parametro è facoltativo e può essere impostato su NULL.
[out] Buffer
Puntatore a un buffer che riceve i dati della proprietà richiesti. Per altre informazioni su questo parametro e sul parametro buffer-size pulLength, vedere la sezione osservazioni seguente.
[in, out] pulLength
Puntatore a variabile di tipo ULONG il cui valore, in input, è la dimensione, in byte, del buffer fornito da Buffer. In caso di restituzione, CM_Get_Class_Registry_Property imposta questa variabile sulle dimensioni, in byte, della proprietà richiesta.
[in] ulFlags
Riservato solo per uso interno. Deve essere impostato su zero.
[in, optional] hMachine
Handle per un computer remoto da cui recuperare la proprietà della classe di dispositivo specificata. Questo parametro è facoltativo e, se è impostato su NULL, la proprietà viene recuperata dal computer locale.
Se l'operazione ha esito positivo, CM_Get_Class_Registry_Property restituisce CR_SUCCESS. In caso contrario, la funzione restituisce uno degli altri codici di stato CR_Xxx definiti in Cfgmgr32.h.
Per determinare le dimensioni, in byte, di una proprietà prima di tentare di recuperare la proprietà, chiamare prima CM_Get_Class_Registry_Property, specificando un puntatore NULLBuffer e un pulLength valore pari a zero. In risposta a una chiamata di questo tipo, la funzione non recupera la proprietà , ma imposta pulLength sulla dimensione della proprietà richiesta e restituisce CR_BUFFER_SMALL. Dopo aver ottenuto le dimensioni della proprietà, chiamare di nuovo CM_Get_Class_Registry_Property, specificando un puntatore Buffer al buffer per ricevere i dati della proprietà e specificando le dimensioni della proprietà in *pulLength.
| 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 |
CM_Set_Class_Registry_Property