CM_Set_Class_Registry_PropertyA-Funktion (cfgmgr32.h)

Artikel
08/22/2023

Die CM_Set_Class_Registry_Property-Funktion legt eine Eigenschaft einer Gerätesetupklasse fest oder löscht sie.

Syntax

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

Parameter

[in] ClassGuid

Ein Zeiger auf die GUID, die die Geräteeinrichtungsklasse darstellt, für die eine Eigenschaft festgelegt werden soll.

[in] ulProperty

Ein Wert vom Typ ULONG, der die festzulegende Eigenschaft identifiziert. Dieser Wert muss einer der CM_CRP_Xxx-Werte sein, die für den ulProperty-Parameter der CM_Get_Class_Registry_Property-Funktion beschrieben werden.

[in, optional] Buffer

Ein Zeiger auf einen Puffer, der die Eigenschaftendaten enthält. Dieser Parameter ist optional und kann auf NULL festgelegt werden. Weitere Informationen zum Festlegen dieses Parameters und des entsprechenden ulLength-Parameters finden Sie im folgenden Abschnitt Hinweise .

[in] ulLength

Ein Wert vom Typ ULONG, der die Größe der Eigenschaftendaten in Bytes angibt.

[in] ulFlags

Nur für die interne Verwendung vorgesehen. Muss auf 0 festgelegt werden.

[in, optional] hMachine

Ein Handle für einen Remotecomputer, auf dem die angegebene Geräteeinrichtungsklasseneigenschaft festgelegt werden soll. Dieser Parameter ist optional. Wenn sie auf NULL festgelegt ist, wird die Eigenschaft auf dem lokalen Computer festgelegt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt CM_Set_Class_Registry_Property CR_SUCCESS zurück. Andernfalls gibt die Funktion einen der anderen CR_Xxx-status-Codes zurück, die in Cfgmgr32.h definiert sind.

Hinweise

Wenn BufferNULL ist, muss ulLength auf Null festgelegt werden.

Wenn ulLength auf null festgelegt ist, löscht die -Funktion die -Eigenschaft.

Wenn Buffer nicht auf NULL und ulLength nicht auf Null festgelegt ist, muss der angegebene Wert die richtige Größe für den datentyp REG_Xxx für die eigenschaft sein, die in ulProperty angegeben ist.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Universell
Header	cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Weitere Informationen

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty

Freigeben über