wmi Win32_OperatingSystem reference for Network Programming in .NET with C# & Visual Basic .NET (VB.NET)

WMI class ' Win32_OperatingSystem ' reference for C# and VB.NET

MOF Reference

[Description("The Win32_OperatingSystem class represents an operating system installed on a Win32 computer system. Any operating system that can be installed on a Win32 system is a descendent (or member) of this class.\nExample: Microsoft Windows 95."): ToSubClass, AMENDMENT, LOCALE(1033)]
class Win32_OperatingSystem : CIM_OperatingSystem
{
	[Description("The Description property provides a description of the Windows operating system. Some user interfaces (those that allow editing of this description) limit its length to 48 characters."): ToSubClass] string Description = NULL;
	[Description("The Version property indicates the version number of the operating system.\nExample: 4.0"): ToSubClass] string Version = NULL;
	[Description("The BootDevice property indicates the name of the disk drive from which the Win32 operating system boots. \nExample: \\\\Device\\Harddisk0."): ToSubClass] string BootDevice;
	[Description("The BuildNumber property indicates the build number of the operating system.  It can be used for more precise versioning information than product release version numbers\nExample: 1381"): ToSubClass] string BuildNumber;
	[Description("The BuildType property indicates the type of build used for the operating system. Examples are retail build and checked build."): ToSubClass] string BuildType;
	[Description("The CodeSet property indicates the code page value used by the operating system. A code page contains a character table used by the operating system to translate strings for different languages. The American National Standards Institute (ANSI) lists values that represent defined code pages. If the operating system does not use an ANSI code page, this member will be set to 0. The CodeSet string can use up to six characters to define the code page value.\nExample: 1255."): ToSubClass] string CodeSet;
	[Description("The CountryCode property indicates the code for the country/regionused by the operating system. Values are based on international phone dialing prefixes (also referred to as IBM country/region codes). The CountryCode string can use up to six characters to define the country/region code value.\nExample: 1 for the United States)"): ToSubClass] string CountryCode;
	[Description("The CSDVersion property contains a null-terminated string, that indicates the latest Service Pack installed on the computer system. If no Service Pack is installed, the string is NULL. For computer systems running Windows 95, this property contains a null-terminated string that provides arbitrary additional information about the operating system.\nExample: Service Pack 3."): ToSubClass] string CSDVersion;
	[Description("The Debug property indicates whether the operating system is a checked (debug) build. Checked builds provide error checking, argument verification, and system debugging code. Additional code in a checked binary generates a kernel debugger error message and breaks into the debugger. This helps  immediately determine the cause and location of the error. Performance suffers in the checked build due to the additional code that is executed.\nValues: TRUE or FALSE, A value of TRUE indicates the debugging version of User.exe is installed."): ToSubClass] boolean Debug;
	[Description("The ForegroundApplicationBoost property indicates the increase in priority given to the foreground application. On computer systems running Windows NT 4.0 and Windows 2000, application boost is implemented by giving an application more execution time slices (quantum lengths). A ForegroundApplicationBoost value of 0 indicates the system boosts the quantum length by 6; if 1, then 12; and if 2 then 18. On Windows NT 3.51 and earlier, application boost is implemented by increasing the scheduling priority. For these systems, the scheduling priority is increased by the value of this property. The default value is 2."): ToSubClass, Values{"None", "Minimum", "Maximum"}: ToSubClass] uint8 ForegroundApplicationBoost;
	[Description("The Locale property indicates the language identifier used by the operating system. A language identifier is a standard international numeric abbreviation for a country or region. Each language has a unique language identifier (LANGID), a 16-bit value that consists of a primary language identifier and a secondary language identifier."): ToSubClass] string Locale;
	[Description("The Manufacturer property indicates the name of the operating system manufacturer.  For Win32 systems this value will be Microsoft Corporation."): ToSubClass] string Manufacturer;
	[Description("The Organization property indicates the registered user's (of the operating system) company name.\nExample: Microsoft Corporation."): ToSubClass] string Organization;
	[Description("The OSLanguage property indicates which language version of the operating system is installed.\nExample: 0x0807 (German, Switzerland)"): ToSubClass] uint32 OSLanguage;
	[Description("The OSProductSuite property identifies installed and licensed system product additions to the operating system."): ToSubClass, BitValues{"Small Business", "Enterprise", "BackOffice", "Communication Server", "Terminal Server", "Small Business(Restricted)", "Embedded NT", "Data Center"}: ToSubClass] uint32 OSProductSuite;
	[Description("The PlusProductID property contains the product identification number for the Windows Plus! operating system enhancement software (if installed)."): ToSubClass] string PlusProductID;
	[Description("The PlusVersionNumber property contains the version number of the Windows Plus! operating system enhancement software (if installed)."): ToSubClass] string PlusVersionNumber;
	[Description("The Primary property determines whether this is the primary operating system.\nValues: TRUE or FALSE. A value of TRUE indicates this is the primary operating system."): ToSubClass] boolean Primary;
	[Description("The QuantumLength property defines the number of clock ticks per quantum. A quantum is a unit of execution time that the scheduler is allowed to give to an application before switching to other applications. When a thread runs one quantum, the kernel preempts it and moves it to the end of a queue for applications with equal priorities. The actual length of a thread's quantum varies across different Windows platforms. For Windows NT/Windows 2000 only."): ToSubClass, Values{"Unknown", "One tick", "Two ticks"}: ToSubClass] uint8 QuantumLength;
	[Description("The QuantumType property specifies either fixed or variable length quantums. Windows NT 4.0 Workstation/Windows 2000 defaults to variable length quantums where the foreground application has a longer quantum than the background applications. Windows NT Server defaults to fixed-length quantums. A quantum is a unit of execution time that the scheduler is allowed to give to an application before switching to another application. When a thread runs one quantum, the kernel preempts it and moves it to the end of a queue for applications with equal priorities. The actual length of a thread's quantum varies across different Windows platforms. For Windows NT/Windows 2000 only.\nThe property can take the following values: \n0 = Unkown - Quantum Type not known.\n1 = Fixed - Quantum length is fixed.\n2 = Variable - Quantum length is variable."): ToSubClass, Values{"Unknown", "Fixed", "Variable"}: ToSubClass] uint8 QuantumType;
	[Description("The RegisteredUser property indicates the name of the registered user of the operating system.\nExample: Jane Doe"): ToSubClass] string RegisteredUser;
	[Description("The SerialNumber property indicates the operating system product serial identification number.\nExample:10497-OEM-0031416-71674."): ToSubClass] string SerialNumber;
	[Description("The ServicePackMajorVersion property indicates the major version number of the service pack installed on the computer system. If no service pack has been installed, the value is zero. ServicePackMajorVersion is valid for computers running Windows 2000 and later (NULL otherwise)."): ToSubClass] uint16 ServicePackMajorVersion;
	[Description("The ServicePackMinorVersion property indicates the minor version number of the service pack installed on the computer system. If no service pack has been installed, the value is zero. ServicePackMinorVersion is valid for computers running Windows 2000 and later (NULL otherwise)."): ToSubClass] uint16 ServicePackMinorVersion;
	[Description("The SystemDevice property indicates the physical disk partition the operating system is installed on."): ToSubClass] string SystemDevice;
	[Description("The SystemDirectory property indicates the system directory of the operating system.\nExample: C:\\WINDOWS\\SYSTEM32"): ToSubClass] string SystemDirectory;
	[Description("The SystemDrive property contains the letter of the disk drive that the operating system resides on.\nExample: C:"): ToSubClass] string SystemDrive;
	[Description("The WindowsDirectory property indicates the Windows directory of the operating system.\nExample: C:\\WINDOWS"): ToSubClass] string WindowsDirectory;
	[Description("The EncryptionLevel property specifies if the encryption level for secure transactions is 40-bit, 128-bit, or n-bit encryption."): ToSubClass, Values{"40-bit", "128-bit", "n-bit"}: ToSubClass] uint32 EncryptionLevel;
	[Description("The LargeSystemCache property indicates whether to optimize memory for applications (value=0) or for system performance (value=1)."): ToSubClass, Values{"Optimize for Applications", "Optimize for System Performance"}: ToSubClass] uint32 LargeSystemCache;
	[Description("The SuiteMask property indicates a set of bit flags that identify the product suites available on the system. This member can be a combination of the following values: \n0 - Small Business \n1 - Enterprise \n2 - Backoffice \n3 - Communications \n4 - Terminal \n5 - Smallbusiness Restricted \n6 - Embedded NT \n7 - Data Center \n8 - Singe User \n9 - Personal \n10 - Blade \n30 - NT Work Station \n31 - NT Server"): ToSubClass, BitValues{"Small Business", "Enterprise", "Backoffice", "Communications", "Terminal", "Smallbusiness Restricted", "Embedded NT", "Data Center", "Singe User", "Personal", "Blade", "NT Work Station", "NT Server"}: ToSubClass] uint32 SuiteMask;
	[Description("The ProductType property indicates additional information about the system. This member can be one of the following values: \n1 - Work Station \n2 - Domain Controller \n3 - Server"): ToSubClass, Values{"Work Station", "Domain Controller", "Server"}: ToSubClass] uint32 ProductType;
	[Description("The Reboot method shuts down the computer system, then restarts it. On computers running Windows NT/2000, the calling process must have the SE_SHUTDOWN_NAME privilege.\nThe method returns an integer value that can be interpretted as follows: \n0 - Successful completion.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 Reboot();
	[Description("The Shutdown method unloads programs and DLLs to the point where it is safe to turn off the computer. All file buffers are flushed to disk, and all running processes are stopped. On computer systems running Windows NT/2000, the calling process must have the SE_SHUTDOWN_NAME privilege.\nThe method returns an integer value that can be interpretted as follows: \n0 - Successful completion.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 Shutdown();
	[Description("The Win32Shutdown method provides the full set of shutdown options supported by Win32 operating systems.\nThe method returns an integer value that can be interpretted as follows: \n0 - Successful completion.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 Win32Shutdown([in, Description("The Flags parameter contains a set of flags to shut the computer down.  The setting this parameter to 0 is the command to logoff."): ToSubClass, BitValues{"Shutdown", "Reboot", "Force", "Power Off"}: ToSubClass] sint32 Flags, [in, Description("The Reserved parameter provides a way to extend Win32Shutdown. Presently, the Reserved parameter is ignored."): ToSubClass] sint32 Reserved);
	[Description("The SetDateTime method sets the current system time on the computer.  On computer systems running Windows NT/2000, the calling process must have the SE_SYSTEMTIME_NAME privilege.\nThe method returns an integer value that can be interpretted as follows: \n0 - Successful completion.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 SetDateTime([in, Description("The LocalDateTime parameter is the time to set.  This property may not be NULL."): ToSubClass] DateTime LocalDateTime);
};

Class properties:

Win32_OperatingSystem.BootDevice
Win32_OperatingSystem.BuildNumber
Win32_OperatingSystem.BuildType
Win32_OperatingSystem.Caption
Win32_OperatingSystem.CodeSet
Win32_OperatingSystem.CountryCode
Win32_OperatingSystem.CreationClassName
Win32_OperatingSystem.CSCreationClassName
Win32_OperatingSystem.CSDVersion
Win32_OperatingSystem.CSName
Win32_OperatingSystem.CurrentTimeZone
Win32_OperatingSystem.Debug
Win32_OperatingSystem.Description
Win32_OperatingSystem.Distributed
Win32_OperatingSystem.EncryptionLevel
Win32_OperatingSystem.ForegroundApplicationBoost
Win32_OperatingSystem.FreePhysicalMemory
Win32_OperatingSystem.FreeSpaceInPagingFiles
Win32_OperatingSystem.FreeVirtualMemory
Win32_OperatingSystem.InstallDate
Win32_OperatingSystem.LargeSystemCache
Win32_OperatingSystem.LastBootUpTime
Win32_OperatingSystem.LocalDateTime
Win32_OperatingSystem.Locale
Win32_OperatingSystem.Manufacturer
Win32_OperatingSystem.MaxNumberOfProcesses
Win32_OperatingSystem.MaxProcessMemorySize
Win32_OperatingSystem.Name
Win32_OperatingSystem.NumberOfLicensedUsers
Win32_OperatingSystem.NumberOfProcesses
Win32_OperatingSystem.NumberOfUsers
Win32_OperatingSystem.Organization
Win32_OperatingSystem.OSLanguage
Win32_OperatingSystem.OSProductSuite
Win32_OperatingSystem.OSType
Win32_OperatingSystem.OtherTypeDescription
Win32_OperatingSystem.PlusProductID
Win32_OperatingSystem.PlusVersionNumber
Win32_OperatingSystem.Primary
Win32_OperatingSystem.ProductType
Win32_OperatingSystem.QuantumLength
Win32_OperatingSystem.QuantumType
Win32_OperatingSystem.RegisteredUser
Win32_OperatingSystem.SerialNumber
Win32_OperatingSystem.ServicePackMajorVersion
Win32_OperatingSystem.ServicePackMinorVersion
Win32_OperatingSystem.SizeStoredInPagingFiles
Win32_OperatingSystem.Status
Win32_OperatingSystem.SuiteMask
Win32_OperatingSystem.SystemDevice
Win32_OperatingSystem.SystemDirectory
Win32_OperatingSystem.SystemDrive
Win32_OperatingSystem.TotalSwapSpaceSize
Win32_OperatingSystem.TotalVirtualMemorySize
Win32_OperatingSystem.TotalVisibleMemorySize
Win32_OperatingSystem.Version
Win32_OperatingSystem.WindowsDirectory

WMI is a huge subject, so therefore it is practically impossible to provide a comprehensive example program that covers anything. However, the book �Network programming in .NET� (Buy at Amazon UK) (Buy at Amazon US) covers a much wider scope of WMI, and explains how to leverage it to access the bounty of information held within this vast, yet simple object model.

Articles

Contact us

Please use FireFox to view this page

WMI class ' Win32_OperatingSystem ' reference for C# and VB.NET

MOF Reference

Class properties: