Операции Windows (C++/CLI)

Статья
08/08/2022
Чтение занимает 7 мин

демонстрирует различные задачи, связанные с Windows, с использованием Windows SDK.

в следующих разделах демонстрируются различные операции Windows, выполняемые с Windows SDK с помощью Visual C++.

Определить, запущено ли завершение работы

в следующем примере кода показано, как определить, завершается ли в данный момент приложение или платформа .NET Framework. это полезно для доступа к статическим элементам в платформа .NET Framework поскольку во время завершения работы эти конструкции завершаются системой и не могут быть надежно использованы. Сначала проверив HasShutdownStarted свойство, можно избежать потенциальных сбоев, не обращаясь к этим элементам.

Пример

// check_shutdown.cpp
// compile with: /clr
using namespace System;
int main()
{
   if (Environment::HasShutdownStarted)
      Console::WriteLine("Shutting down.");
   else
      Console::WriteLine("Not shutting down.");
   return 0;
}

Определение интерактивного состояния пользователя

В следующем примере кода показано, как определить, выполняется ли код в интерактивном контексте пользователя. Если UserInteractive имеет значение false, то код выполняется как процесс службы или в веб-приложении. в этом случае не следует пытаться взаимодействовать с пользователем.

Пример

// user_interactive.cpp
// compile with: /clr
using namespace System;

int main()
{
   if ( Environment::UserInteractive )
      Console::WriteLine("User interactive");
   else
      Console::WriteLine("Noninteractive");
   return 0;
}

чтение данных из реестра Windows

в следующем примере кода используется CurrentUser ключ для чтения данных из реестра Windows. Во-первых, подразделы перечисляются с помощью GetSubKeyNames метода, а затем подраздел удостоверений открывается с помощью OpenSubKey метода. Как и корневые ключи, каждый подраздел представлен RegistryKey классом. Наконец, для перечисления пар "ключ-значение" используется новый RegistryKey объект.

Пример

// registry_read.cpp
// compile with: /clr
using namespace System;
using namespace Microsoft::Win32;

int main( )
{
   array<String^>^ key = Registry::CurrentUser->GetSubKeyNames( );

   Console::WriteLine("Subkeys within CurrentUser root key:");
   for (int i=0; i<key->Length; i++)
   {
      Console::WriteLine("   {0}", key[i]);
   }

   Console::WriteLine("Opening subkey 'Identities'...");
   RegistryKey^ rk = nullptr;
   rk = Registry::CurrentUser->OpenSubKey("Identities");
   if (rk==nullptr)
   {
      Console::WriteLine("Registry key not found - aborting");
      return -1;
   }

   Console::WriteLine("Key/value pairs within 'Identities' key:");
   array<String^>^ name = rk->GetValueNames( );
   for (int i=0; i<name->Length; i++)
   {
      String^ value = rk->GetValue(name[i])->ToString();
      Console::WriteLine("   {0} = {1}", name[i], value);
   }

   return 0;
}

Примечания

RegistryКласс является просто контейнером для статических экземпляров RegistryKey . Каждый экземпляр представляет корневой узел реестра. Экземпляры: ClassesRoot , LocalMachine CurrentConfig CurrentUser ,, и. Users

Помимо статического, объекты в Registry классе доступны только для чтения. Кроме того, экземпляры RegistryKey класса, созданные для доступа к содержимому объектов реестра, также доступны только для чтения. пример переопределения этого поведения см. в разделе практические руководства. запись данных в реестр Windows (C++/cli).

В Registry классе есть два дополнительных объекта: DynData и PerformanceData . Оба являются экземплярами RegistryKey класса. DynDataобъект содержит динамические сведения реестра, которые поддерживаются только в Windows 98 и Windows Me. PerformanceDataобъект можно использовать для доступа к сведениям счетчика производительности приложений, использующих систему мониторинга производительности Windows. PerformanceDataУзел представляет сведения, которые фактически не хранятся в реестре и поэтому не могут быть просмотрены с помощью Regedit.exe.

чтение счетчиков производительности Windows

некоторые приложения и Windows подсистемы предоставляют данные о производительности с помощью Windows системы производительности. Доступ к этим счетчикам можно получить с помощью PerformanceCounterCategory классов и PerformanceCounter , которые находятся в System.Diagnostics пространстве имен.

в следующем примере кода эти классы используются для извлечения и отображения счетчика, который обновляется Windows, чтобы указать процент времени, в течение которого процессор занят.

Примечание

В этом примере требуются права администратора для работы в Windows Vista.

Пример

// processor_timer.cpp
// compile with: /clr
#using <system.dll>

using namespace System;
using namespace System::Threading;
using namespace System::Diagnostics;
using namespace System::Timers;

ref struct TimerObject
{
public:
   static String^ m_instanceName;
   static PerformanceCounter^ m_theCounter;

public:
   static void OnTimer(Object^ source, ElapsedEventArgs^ e)
   {
      try
      {
         Console::WriteLine("CPU time used: {0,6} ",
          m_theCounter->NextValue( ).ToString("f"));
      }
      catch(Exception^ e)
      {
         if (dynamic_cast<InvalidOperationException^>(e))
         {
            Console::WriteLine("Instance '{0}' does not exist",
                  m_instanceName);
            return;
         }
         else
         {
            Console::WriteLine("Unknown exception... ('q' to quit)");
            return;
         }
      }
   }
};

int main()
{
   String^ objectName = "Processor";
   String^ counterName = "% Processor Time";
   String^ instanceName = "_Total";

   try
   {
      if ( !PerformanceCounterCategory::Exists(objectName) )
      {
         Console::WriteLine("Object {0} does not exist", objectName);
         return -1;
      }
   }
   catch (UnauthorizedAccessException ^ex)
   {
      Console::WriteLine("You are not authorized to access this information.");
      Console::Write("If you are using Windows Vista, run the application with ");
      Console::WriteLine("administrative privileges.");
      Console::WriteLine(ex->Message);
      return -1;
   }

   if ( !PerformanceCounterCategory::CounterExists(
          counterName, objectName) )
   {
      Console::WriteLine("Counter {0} does not exist", counterName);
      return -1;
   }

   TimerObject::m_instanceName = instanceName;
   TimerObject::m_theCounter = gcnew PerformanceCounter(
          objectName, counterName, instanceName);

   System::Timers::Timer^ aTimer = gcnew System::Timers::Timer();
   aTimer->Elapsed += gcnew ElapsedEventHandler(&TimerObject::OnTimer);
   aTimer->Interval = 1000;
   aTimer->Enabled = true;
   aTimer->AutoReset = true;

   Console::WriteLine("reporting CPU usage for the next 10 seconds");
   Thread::Sleep(10000);
   return 0;
}

Извлечение текста из буфера обмена

В следующем примере кода функция-член используется GetDataObject для возвращения указателя на IDataObject интерфейс. Затем этот интерфейс может запрашивать формат данных и использоваться для получения фактических данных.

Пример

// read_clipboard.cpp
// compile with: /clr
#using <system.dll>
#using <system.Drawing.dll>
#using <system.windows.forms.dll>

using namespace System;
using namespace System::Windows::Forms;

[STAThread] int main( )
{
   IDataObject^ data = Clipboard::GetDataObject( );

   if (data)
   {
      if (data->GetDataPresent(DataFormats::Text))
      {
         String^ text = static_cast<String^>
           (data->GetData(DataFormats::Text));
         Console::WriteLine(text);
      }
      else
         Console::WriteLine("Nontext data is in the Clipboard.");
   }
   else
   {
      Console::WriteLine("No data was found in the Clipboard.");
   }

   return 0;
}

Получение текущего имени пользователя

В следующем примере кода показано получение имени текущего пользователя (имя пользователя, вошедшего в Windows). Имя хранится в UserName строке, которая определена в Environment пространстве имен.

Пример

// username.cpp
// compile with: /clr
using namespace System;

int main()
{
   Console::WriteLine("\nCurrent user: {0}", Environment::UserName);
   return 0;
}

получение версии платформа .NET Framework

в следующем примере кода показано, как определить версию установленного платформа .NET Framework со Version свойством, которое является указателем на Version объект, содержащий сведения о версии.

Пример

// dotnet_ver.cpp
// compile with: /clr
using namespace System;
int main()
{
   Version^ version = Environment::Version;
   if (version)
   {
      int build = version->Build;
      int major = version->Major;
      int minor = version->Minor;
      int revision = Environment::Version->Revision;
      Console::Write(".NET Framework version: ");
      Console::WriteLine("{0}.{1}.{2}.{3}",
            build, major, minor, revision);
   }
   return 0;
}

Получение имени локального компьютера

В следующем примере кода показано получение имени локального компьютера (имя компьютера в том виде, в котором оно отображается в сети). Это можно сделать, получив MachineName строку, которая определена в Environment пространстве имен.

Пример

// machine_name.cpp
// compile with: /clr
using namespace System;

int main()
{
   Console::WriteLine("\nMachineName: {0}", Environment::MachineName);
   return 0;
}

получение версии Windows

В следующем примере кода показано, как получить сведения о платформе и версии текущей операционной системы. эта информация хранится в System.Environment.OSVersion свойстве и состоит из перечисления, описывающего версию Windows в широком смысле, и Version объект, содержащий точную сборку операционной системы.

Пример

// os_ver.cpp
// compile with: /clr
using namespace System;

int main()
{
   OperatingSystem^ osv = Environment::OSVersion;
   PlatformID id = osv->Platform;
   Console::Write("Operating system: ");

   if (id == PlatformID::Win32NT)
      Console::WriteLine("Win32NT");
   else if (id == PlatformID::Win32S)
      Console::WriteLine("Win32S");
   else if (id == PlatformID::Win32Windows)
      Console::WriteLine("Win32Windows");
   else
      Console::WriteLine("WinCE");

   Version^ version = osv->Version;
   if (version)
   {
      int build = version->Build;
      int major = version->Major;
      int minor = version->Minor;
      int revision = Environment::Version->Revision;
      Console::Write("OS Version: ");
      Console::WriteLine("{0}.{1}.{2}.{3}",
                   build, major, minor, revision);
   }

   return 0;
}

Получить время, прошедшее с момента запуска

в следующем примере кода показано, как определить число тактов или число миллисекунд, прошедших с момента запуска Windows. Это значение хранится в System.Environment.TickCount элементе и, поскольку это 32-разрядное значение, сбрасывается в ноль примерно каждые 24,9 дней.

Пример

// startup_time.cpp
// compile with: /clr
using namespace System;

int main( )
{
   Int32 tc = Environment::TickCount;
   Int32 seconds = tc / 1000;
   Int32 minutes = seconds / 60;
   float hours = static_cast<float>(minutes) / 60;
   float days = hours / 24;

   Console::WriteLine("Milliseconds since startup: {0}", tc);
   Console::WriteLine("Seconds since startup: {0}", seconds);
   Console::WriteLine("Minutes since startup: {0}", minutes);
   Console::WriteLine("Hours since startup: {0}", hours);
   Console::WriteLine("Days since startup: {0}", days);

   return 0;
}

Хранение текста в буфере обмена

В следующем примере кода для хранения строки используется Clipboard объект, определенный в System.Windows.Forms пространстве имен. Этот объект предоставляет две функции элементов: SetDataObject и GetDataObject . Данные хранятся в буфере обмена путем отправки любого объекта, производного от Object , в SetDataObject .

Пример

// store_clipboard.cpp
// compile with: /clr
#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

[STAThread] int main()
{
   String^ str = "This text is copied into the Clipboard.";

   // Use 'true' as the second argument if
   // the data is to remain in the clipboard
   // after the program terminates.
   Clipboard::SetDataObject(str, true);

   Console::WriteLine("Added text to the Clipboard.");

   return 0;
}

запись данных в реестр Windows

В следующем примере кода используется CurrentUser ключ для создания доступного для записи экземпляра класса, RegistryKey соответствующего программному ключу. CreateSubKeyЗатем метод используется для создания нового ключа и добавления в пары "ключ-значение".

Пример

// registry_write.cpp
// compile with: /clr
using namespace System;
using namespace Microsoft::Win32;

int main()
{
   // The second OpenSubKey argument indicates that
   // the subkey should be writable.
   RegistryKey^ rk;
   rk  = Registry::CurrentUser->OpenSubKey("Software", true);
   if (!rk)
   {
      Console::WriteLine("Failed to open CurrentUser/Software key");
      return -1;
   }

   RegistryKey^ nk = rk->CreateSubKey("NewRegKey");
   if (!nk)
   {
      Console::WriteLine("Failed to create 'NewRegKey'");
      return -1;
   }

   String^ newValue = "NewValue";
   try
   {
      nk->SetValue("NewKey", newValue);
      nk->SetValue("NewKey2", 44);
   }
   catch (Exception^)
   {
      Console::WriteLine("Failed to set new values in 'NewRegKey'");
      return -1;
   }

   Console::WriteLine("New key created.");
   Console::Write("Use REGEDIT.EXE to verify ");
   Console::WriteLine("'CURRENTUSER/Software/NewRegKey'\n");
   return 0;
}

Примечания

платформа .NET Framework можно использовать для доступа к реестру с Registry помощью классов и RegistryKey , которые определены в Microsoft.Win32 пространстве имен. Класс реестра — это контейнер для статических экземпляров RegistryKey класса. Каждый экземпляр представляет корневой узел реестра. Экземпляры: ClassesRoot , LocalMachine CurrentConfig CurrentUser ,, и. Users

Environment

См. также

Программирование .NET с использованием C++/CLI (Visual C++)

Операции Windows (C++/CLI)

Определить, запущено ли завершение работы

Пример

Определение интерактивного состояния пользователя

Пример

чтение данных из реестра Windows

Пример

Примечания

чтение счетчиков производительности Windows

Пример

Извлечение текста из буфера обмена

Пример

Получение текущего имени пользователя

Пример

получение версии платформа .NET Framework

Пример

Получение имени локального компьютера

Пример

получение версии Windows

Пример

Получить время, прошедшее с момента запуска

Пример

Хранение текста в буфере обмена

Пример

запись данных в реестр Windows

Пример

Примечания

Связанные разделы

См. также