Função WritePropertyValue
Escreve um número especificado de bytes numa propriedade identificada por um identificador de propriedade.
Nota
Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.
Sintaxe
HRESULT WritePropertyValue (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] long lHandle,
[in] long lNumBytes,
[in] byte* aData
);
Parâmetros
vFunc
[in] Este parâmetro não é utilizado.
ptr
[in] Um ponteiro para uma instância IWbemObjectAccess .
lHandle
[in] Um número inteiro que contém o identificador que identifica esta propriedade. A alça pode ser obtida ao chamar a função GetPropertyHandle .
lNumBytes
[in] O número de bytes escritos na propriedade. Consulte a secção Observações para obter mais informações.
pHandle [fora] Um ponteiro para a matriz de bytes que contém os dados.
Valor devolvido
Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:
| Constante | Valor | Descrição |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | Um parâmetro não é válido. |
WBEM_E_TYPE_MISMATCH |
0x80041005 | Ocorreu um erro de correspondência de tipo. |
WBEM_S_NO_ERROR |
0 | A chamada da função foi efetuada com êxito. |
Observações
Esta função encapsula uma chamada para o método IWbemClassObject::WritePropertyValue .
Utilize esta função para definir a cadeia e todos os outros dadosDWORD não ou nãoQWORD .
Para valores de propriedade nãostring, lNumBytes tem de ser o tamanho de dados correto do tipo de propriedade especificado. Para valores de propriedade de cadeia, lNumBytes tem de ter o comprimento da cadeia especificada em bytes e a cadeia em si tem de ter um comprimento uniforme em bytes e ser seguida com um caráter de terminação nula.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: WMINet_Utils.idl
.NET Framework Versões: Disponível desde a versão 4.7.2
