funzione CM_Get_Class_Registry_PropertyW (cfgmgr32.h)

Articolo
03/05/2024

La funzione CM_Get_Class_Registry_Property recupera una proprietà della classe di installazione del dispositivo.

Sintassi

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
);

Parametri

[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 CM_CRP_Xxx seguenti definiti in Cfgmgr32.h:

CM_CRP_UPPERFILTERS

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.

CM_CRP_LOWERFILTERS

Rappresenta un elenco REG_MULTI_SZ tipizzato di stringhe, in cui ogni stringa contiene il nome di un driver di filtro di livello inferiore registrato per la classe.

CM_CRP_SECURITY

Rappresenta un valore di tipo REG_BINARY che contiene una struttura a lunghezza variabile, auto-relativa, SECURITY_DESCRIPTOR .

CM_CRP_SECURITY_SDS

Rappresenta una stringa di tipo REG_SZ che contiene un descrittore di sicurezza nel formato SDDL (Security Descriptor Definition Language).

CM_CRP_DEVTYPE

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.

CM_CRP_EXCLUSIVE

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 l'accesso esclusivo è consentito o zero in caso contrario.

CM_CRP_CHARACTERISTICS

Rappresenta un valore di tipo DWORD che indica le caratteristiche del dispositivo per la classe. Per un elenco di 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 costanti REG_Xxx 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 delle dimensioni del buffer pulLength, vedere la sezione Osservazioni seguenti.

[in, out] pulLength

Puntatore alla 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 esclusivamente per uso interno. Deve essere impostato su zero.

[in, optional] hMachine

Handle a 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.

Valore restituito

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.

Commenti

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 del bufferNULL e un valore pulLength pari a zero. In risposta a tale chiamata, la funzione non recupera la proprietà, ma imposta pulLength sulle dimensioni della proprietà richiesta e restituisce CR_BUFFER_SMALL. Dopo aver ottenuto le dimensioni della proprietà, chiamare di nuovo CM_Get_Class_Registry_Property , fornendo un puntatore buffer al buffer per ricevere i dati della proprietà e specificare le dimensioni della proprietà in *pulLength.

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