função CM_Set_Class_Registry_PropertyA (cfgmgr32.h)

A função CM_Set_Class_Registry_Property define ou exclui uma propriedade de uma classe de configuração de dispositivo.

Sintaxe

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

Parâmetros

[in] ClassGuid

Um ponteiro para o GUID que representa a classe de configuração do dispositivo para a qual definir uma propriedade.

[in] ulProperty

Um valor do tipo ULONG que identifica a propriedade a ser definida. Esse valor deve ser um dos valores CM_CRP_Xxx descritos para o parâmetro ulProperty da função CM_Get_Class_Registry_Property .

[in, optional] Buffer

Um ponteiro para um buffer que contém os dados da propriedade. Esse parâmetro é opcional e pode ser definido como NULL. Para obter mais informações sobre como definir esse parâmetro e o parâmetro ulLength correspondente, consulte a seção Comentários a seguir.

[in] ulLength

Um valor do tipo ULONG que especifica o tamanho, em bytes, dos dados da propriedade.

[in] ulFlags

Reservado apenas para uso interno. Deve ser definido como zero.

[in, optional] hMachine

Um identificador para um computador remoto no qual definir a propriedade de classe de configuração do dispositivo especificada. Esse parâmetro é opcional. Se definida como NULL, a propriedade será definida no computador local.

Valor retornado

Se a operação for bem-sucedida, CM_Set_Class_Registry_Property retornará CR_SUCCESS. Caso contrário, a função retornará um dos outros códigos CR_Xxx status definidos em Cfgmgr32.h.

Comentários

Se Buffer for NULL, ulLength deverá ser definido como zero.

Se ulLength estiver definido como zero, a função excluirá a propriedade .

Se Buffer não estiver definido como NULL e ulLength não estiver definido como zero, o valor fornecido deverá ser o tamanho correto para o tipo de dados REG_Xxx para a propriedade especificada em ulProperty.

Requisitos

Cliente mínimo com suporte	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca	Cfgmgr32.lib

Confira também

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty