Función WritePropertyValue
Escribe un número específico de bytes en una propiedad identificada por un controlador de propiedad.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT WritePropertyValue (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] long lHandle,
[in] long lNumBytes,
[in] byte* aData
);
Parámetros
vFunc
[in] Este parámetro no se usa.
ptr
[in] Puntero a una instancia de IWbemObjectAccess.
lHandle
[in] Un entero que contiene el manipulador que identifica esta propiedad. El manipulador se puede recuperar llamando a la función GetPropertyHandle.
lNumBytes
[in] El número de bytes que se escribirán en la propiedad. Para obtener más información, consulte la sección Comentarios.
pHandle [out] Un puntero a la matriz de bytes que contiene los datos.
Valor devuelto
Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:
| Constante | Value | Descripción |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parámetro no es válido. |
WBEM_E_TYPE_MISMATCH |
0x80041005 | Se produjo un desajuste de tipos. |
WBEM_S_NO_ERROR |
0 | Si se devuelve este valor, significará que la llamada a la función se realizó correctamente. |
Comentarios
Esta función encapsula una llamada al método IWbemClassObject::WritePropertyValue.
Use esta función para establecer datos de cadena y todos los demás datos que no sean DWORD ni QWORD.
Para los valores de propiedad que no son de cadena, lNumBytes debe tener el tamaño de datos correcto del tipo de propiedad especificado. Para los valores de propiedad de cadena, lNumBytes debe tener la longitud de la cadena especificada en bytes y la propia cadena debe tener una longitud uniforme en bytes y debe ir seguida de un carácter de terminación NULL.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2
