Constantes de API de scripting

  • Artículo

WMI usa varios tipos de constantes en el parámetro iflags de las llamadas de método en la API de scripting para WMI.

Las aplicaciones de Visual Basic pueden incluir la biblioteca de tipos para la API de scripting, Wbemdisp.tlb. Los scripts no pueden tener acceso a las constantes de la biblioteca de tipos a menos que usen las etiquetas <REFERENCE> u <OBJECT> del formato de archivo XML de Windows Script Host (WSH), tal como se describe en Uso de la biblioteca de tipos de scripting WMI. De lo contrario, un script debe usar el valor de la constante.

Constantes

WbemAuthenticationLevelEnum

Define los niveles de autenticación de seguridad.

WbemChangeFlagEnum

Define cómo se lleva a cabo una operación de escritura en una clase o en una instancia.

WbemCimTypeEnum

Define los tipos CIM válidos de un valor de propiedad.

WbemComparisonFlagEnum

Define la configuración de la comparación de objetos, la usa SWbemObject.CompareTo_.

WbemConnectOptionsEnum

Define una marca de seguridad que se usa como parámetro en llamadas al método SWbemLocator.ConnectServer cuando se produce un error en una conexión a WMI en un equipo remoto.

WbemErrorEnum

Define los errores que puede devolver la API de scripting para las llamadas WMI.

WbemFlagEnum

Define constantes usadas por SWbemServices.ExecQuery, SWbemServices.ExecQueryAsync, SWbemServices.SubclassesOf y SWbemServices.InstancesOf.

WbemImpersonationLevelEnum

Define los niveles de suplantación de seguridad. Estas constantes se usan con SWbemSecurity.

WbemObjectTextFormatEnum

Define los formatos de texto de objeto válidos que va a usar SWbemObjectEx.GetText_.

WbemPrivilegeEnum

Definición de privilegios. Estas constantes se usan con SWbemSecurity para conceder los privilegios necesarios para algunas operaciones.

WbemQueryFlagEnum

Define la profundidad de enumeración o consulta, que determina cuántos objetos devuelve una llamada.

WbemTextFlagEnum

Define el contenido del texto del objeto generado y lo usa SWbemObject.GetObjectText_.

WbemTimeout

Define las constantes de tiempo de espera. SWbemEventSource.NextEvent usa esta constante.

Combinación de marcas

Puede combinar marcas para afectar a más de un aspecto de la llamada API.

Por ejemplo, para crear una llamada semisincrónica, el parámetro iFlags de una llamada a SWbemServices.ExecQuery_ debe contener dos marcas: WbemFlagReturnImmediately y WbemFlagForwardOnly. El valor de WbemFlagReturnImmediately es 16 y el valor de WbemFlagForwardOnly es 32. Dado que no se puede tener acceso a las constantes por nombre, se combinan los valores de estas marcas, lo que genera un valor de iFlags de 48.

En el ejemplo de script siguiente se muestra la llamada.

On Error Resume Next
For Each obj in GetObject("WinMgmts:").ExecQuery _
("SELECT * FROM Win32_NTLogEvent WHERE _ LogFile='Application'",,48)
    count  = count + 1
Next

No todas las marcas se pueden combinar, ya que muchas son mutuamente excluyentes y pueden producir resultados imprevisibles.

API de scripting para WMI