Função WritePropertyValue
Grava um número especificado de bytes em uma propriedade identificada por um identificador de propriedade.
Observação
Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.
Sintaxe
HRESULT WritePropertyValue (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] long lHandle,
[in] long lNumBytes,
[in] byte* aData
);
Parâmetros
vFunc
[in] Esse parâmetro não está em uso.
ptr
[in] Um ponteiro para uma instância IWbemObjectAccess.
lHandle
[in] Um inteiro que contém o identificador dessa propriedade. O identificador pode ser recuperado chamando a função GetPropertyHandle.
lNumBytes
[in] O número de bytes sendo escrito à propriedade. Consulte a seção Comentários para obter mais informações.
pHandle [out] Um ponteiro para a matriz de bytes que contém os dados.
Valor retornado
Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em 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 uma incompatibilidade de tipo. |
WBEM_S_NO_ERROR |
0 | A chamada de função foi bem-sucedida. |
Comentários
Essa função encapsula uma chanada para o método IWbemClassObject::WritePropertyValue.
Use essa função para definir cadeia de caracteres e todos os outros dados não DWORD ou não QWORD.
Para valores de propriedade não cadeia de caracteres, lNumBytes precisa ser o tamanho de dados correto do tipo de propriedade especificado. Para valores de propriedade de cadeia de caracteres, lNumBytes precisa ser o comprimento da cadeia de caracteres especificada em bytes, e a cadeia de caracteres em si precisa ter um comprimento uniforme em bytes e ser seguida com um caractere de encerramento nulo.
Requisitos
Plataformas: confira Requisitos do sistema.
Header: WMINet_Utils.idl
Versões do .NET Framework: Disponível desde 4.7.2
