CM_Set_Class_Registry_PropertyW 함수(cfgmgr32.h)

CM_Set_Class_Registry_Property 함수는 디바이스 설정 클래스의 속성을 설정하거나 삭제합니다.

구문

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

매개 변수

[in] ClassGuid

속성을 설정할 디바이스 설정 클래스를 나타내는 GUID에 대한 포인터입니다.

[in] ulProperty

설정할 속성을 식별하는 ULONG 형식의 값입니다. 이 값은 CM_Get_Class_Registry_Property 함수의 ulProperty 매개 변수에 대해 설명된 CM_CRP_Xxx 값 중 하나여야 합니다.

[in, optional] Buffer

속성 데이터를 포함하는 버퍼에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL로 설정할 수 있습니다. 이 매개 변수 및 해당 ulLength 매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 주의 섹션 을 참조하세요 .

[in] ulLength

속성 데이터의 크기(바이트)를 지정하는 ULONG 형식의 값입니다.

[in] ulFlags

이 속성은 내부 전용으로 예약되어 있으므로 0으로 설정해야 합니다.

[in, optional] hMachine

지정된 디바이스 설정 클래스 속성을 설정할 원격 머신에 대한 핸들입니다. 이 매개 변수는 선택적 요소입니다. NULL로 설정하면 속성이 로컬 컴퓨터에서 설정됩니다.

반환 값

작업이 성공하면 CM_Set_Class_Registry_Property CR_SUCCESS 반환합니다. 그렇지 않으면 함수는 Cfgmgr32.h에 정의된 다른 CR_Xxx 상태 코드 중 하나를 반환합니다.

설명

Buffer가 NULL이면 ulLength를 0으로 설정해야 합니다.

ulLength가 0으로 설정된 경우 함수는 속성을 삭제합니다.

Buffer가 NULL로 설정되지 않고 ulLength가 0으로 설정되지 않은 경우 제공된 값은 ulProperty에 지정된 속성의 REG_Xxx 데이터 형식에 대한 올바른 크기여야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	cfgmgr32.h(Cfgmgr32.h 포함)
라이브러리	Cfgmgr32.lib

추가 정보

CM_Get_Class_Registry_Property

SetupDiGetClassRegistryProperty

SetupDiSetClassRegistryProperty