OpenJobObjectA 関数 (winbase.h)

既存のジョブ オブジェクトを開きます。

構文

HANDLE OpenJobObjectA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

パラメーター

[in] dwDesiredAccess

ジョブ オブジェクトへのアクセス。 このパラメーターには、1 つ以上の ジョブ オブジェクトアクセス権を指定できます。 このアクセス権は、オブジェクトのセキュリティ記述子に対してチェックされます。

[in] bInheritHandle

この値が TRUE の場合、このプロセスによって作成されたプロセスはハンドルを継承します。 それ以外の場合、プロセスはこのハンドルを継承しません。

[in] lpName

開くジョブの名前。 名前の比較では、大文字と小文字が区別されます。

この関数は、プライベート名前空間内のオブジェクトを開くことができます。 詳細については、「 オブジェクト名前空間」を参照してください。

ターミナル サービス: 名前には、グローバル名前空間またはセッション名前空間内のオブジェクトを明示的に開くために、"Global" または "Local" プレフィックスを付けることができます。 名前の残りの部分には、円記号 (\) を除く任意の文字を含めることができます。 詳細については、「 カーネル オブジェクトの名前空間」を参照してください。

戻り値

関数が成功した場合、戻り値はジョブのハンドルです。 ハンドルは、要求されたジョブへのアクセスを提供します。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

ERROR_FILE_NOT_FOUNDのエラーは、 lpName で指定されたジョブが存在しないことを示します。

注釈

プロセスをジョブに関連付けるには、 AssignProcessToJobObject 関数を使用します。

この関数を使用するアプリケーションをコンパイルするには、 _WIN32_WINNT を 0x0500 以降として定義します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

関連項目

AssignProcessToJobObject

ジョブ オブジェクト

プロセス関数とスレッド関数