LibCommon::CProcess クラス

プロセスクラス [詳解]

#include "CProcess.h"

LibCommon::CProcess の継承関係図

LibCommon::CProcess 連携図

公開メンバ関数
	CProcess () noexcept
	コンストラクタ [詳解]
virtual	~CProcess () noexcept
	デストラクタ [詳解]
virtual DWORD	GetProcessId () const noexcept
	プロセスID取得関数 [詳解]
virtual void	Close () noexcept override
	クローズ関数 [詳解]
virtual bool	Release () noexcept override
	リリース関数 [詳解]
virtual bool	Create (wchar_t const *pszPath, wchar_t const *pszArgument=nullptr) noexcept
	作成関数 [詳解]
virtual bool	Open (DWORD dwProcessId, DWORD dwAccess=SYNCHRONIZE) noexcept
	オープン関数 [詳解]
virtual bool	Terminate (DWORD dwExitCode=0) noexcept
	強制終了関数 [詳解]
virtual DWORD	GetExitCode () const noexcept
	終了コード取得関数 [詳解]
基底クラス LibCommon::CSync に属する継承公開メンバ関数
	CSync () noexcept
	コンストラクタ [詳解]
virtual	~CSync () noexcept
	デストラクタ [詳解]
virtual HANDLE	GetHandle () const noexcept
	オブジェクトハンドル取得関数 [詳解]
virtual bool	IsCreate () const noexcept
	新規作成状態取得関数 [詳解]
virtual bool	Wait (DWORD dwTime=INFINITE) noexcept
	ウェイト関数 [詳解]
virtual bool	Lock (DWORD dwTime=INFINITE) noexcept
	ロック関数 [詳解]
virtual bool	Unlock () noexcept
	ロック解除関数 [詳解]

限定公開変数類
DWORD	m_dwProcessId
	プロセスID [詳解]
基底クラス LibCommon::CSync に属する継承限定公開変数類
HANDLE	m_hObject
	オブジェクトハンドル [詳解]
bool	m_bIsCreate
	新規作成フラグ [詳解]

非公開メンバ関数
	CProcess (CProcess const &)=delete
CProcess &	operator= (CProcess const &)=delete

詳解

プロセスクラス

プロセスクラスです。

注意

なし

CProcess.h の 30 行目に定義があります。

構築子と解体子

LibCommon::CProcess::CProcess ( )

explicitnoexcept

コンストラクタ

コンストラクタです。

引数

なし

戻り値

なし

注意

なし

CProcess.cpp の 28 行目に定義があります。

        : CSync()
        // メンバ変数初期化
        , m_dwProcessId( 0 )
    {}

LibCommon::CProcess::~CProcess ( )

virtualnoexcept

デストラクタ

デストラクタです。

引数

なし

戻り値

なし

注意

なし

CProcess.cpp の 37 行目に定義があります。

参照先 Close().

                                 {
        // クローズする
        Close();
    }

呼び出し関係図:

LibCommon::CProcess::CProcess ( CProcess const &  )

privatedelete

関数詳解

virtual DWORD LibCommon::CProcess::GetProcessId ( ) const

inlinevirtualnoexcept

プロセスID取得関数

プロセスID取得関数です。

引数

なし

戻り値

プロセスID

注意

なし

CProcess.h の 68 行目に定義があります。

{ return m_dwProcessId; }

void LibCommon::CProcess::Close ( )

overridevirtualnoexcept

クローズ関数

クローズ関数です。

引数

なし

戻り値

なし

注意

オーバライド関数です。

LibCommon::CSyncを再実装しています。

CProcess.cpp の 46 行目に定義があります。

参照先 LibCommon::CSync::Close(), m_dwProcessId.

参照元 Create(), Open(), LibNewDel::CLibNewDel::UpdateProcessInfo(), LibLogOut::CLibLogOut::UpdateProcessInfo(), ~CProcess().

                                  {
        // 基底クラスの関数を実行する
        CSync::Close();

        // メンバ変数を初期化する
        m_dwProcessId = 0;
    }

呼び出し関係図:

被呼び出し関係図:

bool LibCommon::CProcess::Release ( )

overridevirtualnoexcept

リリース関数

リリース関数です。

引数

なし

戻り値

実行結果

• true 成功
• false 失敗

注意

オーバライド関数です。

LibCommon::CSyncを実装しています。

CProcess.cpp の 56 行目に定義があります。

参照先 Terminate().

                                    {
        // 強制終了する
        return Terminate();
    }

呼び出し関係図:

bool LibCommon::CProcess::Create ( wchar_t const *  pszPath, wchar_t const *  pszArgument = nullptr  )

virtualnoexcept

作成関数

作成関数です。

引数

[in]	pszPath	実行ファイルパス
[in]	pszArgument	引数文字列

戻り値

実行結果

• true 成功
• false 失敗

注意

なし

CProcess.cpp の 63 行目に定義があります。

参照先 Close(), m_dwProcessId, LibCommon::CSync::m_hObject.

                                                                                       {
        // 処理ブロック
        bool result = false;
        do {
            // 実行ファイルパスを調べる
            if ( nullptr == pszPath ) {
                // 失敗！
                break;
            }
            // プロセスハンドルを調べる
            else if ( nullptr != m_hObject ) {
                // クローズする
                Close();
            }

            // 実行ファイルパスをコピーする
            wchar_t szBuffer[ MAX_PATH ];
            ::wcscpy_s( szBuffer, pszPath );

            // 引数文字列を調べる
            if ( nullptr != pszArgument ) {
                // 引数文字列を追加する
                ::wcscat_s( szBuffer, L" \"" );
                ::wcscat_s( szBuffer, pszArgument );
                ::wcscat_s( szBuffer, L"\"" );
            }

            // プロセスを作成する
            STARTUPINFOW        sStartupInfo = {};
            PROCESS_INFORMATION sProcessInfo = {};
            if ( 0 == ::CreateProcessW( nullptr, szBuffer, nullptr, nullptr, false, CREATE_NEW_CONSOLE, nullptr, nullptr, &sStartupInfo, &sProcessInfo ) ) {
                // 失敗！
                break;
            }

            // プロセスハンドルを取得する
            m_hObject = sProcessInfo.hProcess;

            // プロセスIDを取得する
            m_dwProcessId = sProcessInfo.dwProcessId;

            // 成功！
            result = true;
        } while ( false );

        // 実行結果を返す
        return result;
    }

呼び出し関係図:

bool LibCommon::CProcess::Open ( DWORD  dwProcessId, DWORD  dwAccess = SYNCHRONIZE  )

virtualnoexcept

オープン関数

オープン関数です。

引数

[in]	dwProcessId	プロセスID
[in]	dwAccess	アクセスフラグ

戻り値

実行結果

• true 成功
• false 失敗

注意

なし

CProcess.cpp の 114 行目に定義があります。

参照先 Close(), m_dwProcessId, LibCommon::CSync::m_hObject.

参照元 LibNewDel::CLibNewDel::UpdateProcessInfo(), LibLogOut::CLibLogOut::UpdateProcessInfo().

                                                                    {
        // 処理ブロック
        bool result = false;
        do {
            // プロセスハンドルを調べる
            if ( nullptr != m_hObject ) {
                // クローズする
                Close();
            }

            // プロセスをオープンする
            m_hObject = ::OpenProcess( dwAccess, false, dwProcessId );
            if ( nullptr == m_hObject ) {
                // 失敗！
                break;
            }

            // プロセスIDを設定する
            m_dwProcessId = dwProcessId;

            // 成功！
            result = true;
        } while ( false );

        // 実行結果を返す
        return result;
    }

呼び出し関係図:

被呼び出し関係図:

bool LibCommon::CProcess::Terminate ( DWORD  dwExitCode = 0 )

virtualnoexcept

強制終了関数

強制終了関数です。

引数

[in]

dwExitCode

終了コード

戻り値

実行結果

• true 成功
• false 失敗

注意

なし

CProcess.cpp の 144 行目に定義があります。

参照先 LibCommon::CSync::m_hObject.

参照元 Release().

                                                        {
        // 処理ブロック
        bool result = false;
        do {
            // プロセスを強制終了する
            if ( 0 == ::TerminateProcess( m_hObject, dwExitCode ) ) {
                // 失敗！
                break;
            }

            // 成功！
            result = true;
        } while ( false );

        // 実行結果を返す
        return result;
    }

被呼び出し関係図:

DWORD LibCommon::CProcess::GetExitCode ( ) const

virtualnoexcept

終了コード取得関数

終了コード取得関数です。

引数

なし

戻り値

プロセス終了コード

注意

なし

CProcess.cpp の 164 行目に定義があります。

参照先 LibCommon::CSync::m_hObject.

                                               {
        // 処理ブロック
        DWORD result = 0;
        do {
            // プロセス終了コードを取得する
            DWORD dwExitCode;
            if ( 0 == ::GetExitCodeProcess( m_hObject, &dwExitCode ) ) {
                // 失敗！
                break;
            }

            // 成功！
            result = dwExitCode;
        } while ( false );

        // 実行結果を返す
        return result;
    }

CProcess& LibCommon::CProcess::operator= ( CProcess const &  )

privatedelete

メンバ詳解

DWORD LibCommon::CProcess::m_dwProcessId

protected

プロセスID

CProcess.h の 152 行目に定義があります。

参照元 Close(), Create(), Open().

---

このクラス詳解は次のファイルから抽出されました:

• C:/Work/VisualStudio2017/Solution46/Include/Library/LibCommon/CProcess.h
• C:/Work/VisualStudio2017/Solution46/Source/Library/LibCommon/CProcess.cpp