Win32 API 日本語リファレンス
ホームSystem.Threading › CreateProcessAsUserW

CreateProcessAsUserW

関数
指定ユーザートークンのセキュリティ環境で新規プロセスを作成する(Unicode版)。
DLLADVAPI32.dll文字セットUnicode (-W)呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// ADVAPI32.dll  (Unicode / -W)
#include <windows.h>

BOOL CreateProcessAsUserW(
    HANDLE hToken,   // optional
    LPCWSTR lpApplicationName,   // optional
    LPWSTR lpCommandLine,   // optional
    SECURITY_ATTRIBUTES* lpProcessAttributes,   // optional
    SECURITY_ATTRIBUTES* lpThreadAttributes,   // optional
    BOOL bInheritHandles,
    PROCESS_CREATION_FLAGS dwCreationFlags,
    void* lpEnvironment,   // optional
    LPCWSTR lpCurrentDirectory,   // optional
    STARTUPINFOW* lpStartupInfo,
    PROCESS_INFORMATION* lpProcessInformation
);

パラメーター

名前方向説明
hTokenHANDLEinoptional

ユーザーを表すプライマリトークンへのハンドルです。このハンドルには TOKEN_QUERYTOKEN_DUPLICATETOKEN_ASSIGN_PRIMARY のアクセス権が必要です。詳細については、 Access Rights for Access-Token Objects を参照してください。トークンが表すユーザーは、lpApplicationName または lpCommandLine パラメーターで指定されたアプリケーションに対する読み取りおよび実行アクセス権を持っている必要があります。

指定したユーザーを表すプライマリトークンを取得するには、 LogonUser 関数を呼び出します。または、 DuplicateTokenEx 関数を呼び出して、偽装トークンをプライマリトークンに変換することもできます。これにより、クライアントを偽装しているサーバーアプリケーションが、クライアントのセキュリティコンテキストを持つプロセスを作成できます。

hToken が呼び出し元のプライマリトークンの制限付きバージョンである場合、SE_ASSIGNPRIMARYTOKEN_NAME 特権は必要ありません。必要な特権がまだ有効になっていない場合、 CreateProcessAsUser は呼び出しの間それらを有効にします。詳細については、 Running with Special Privileges を参照してください。

ターミナルサービス: プロセスは、トークンで指定されたセッションで実行されます。既定では、これは LogonUser を呼び出したセッションと同じです。セッションを変更するには、 SetTokenInformation 関数を使用します。

lpApplicationNameLPCWSTRinoptional

実行するモジュールの名前です。このモジュールは Windows ベースのアプリケーションにすることができます。ローカルコンピューターに適切なサブシステムが用意されている場合は、それ以外の種類のモジュール(たとえば MS-DOS や OS/2)にすることもできます。

この文字列には、実行するモジュールのフルパスとファイル名を指定するか、部分的な名前を指定できます。部分的な名前の場合、関数は現在のドライブと現在のディレクトリを使用して指定を補完します。この関数は検索パスを使用しません。このパラメーターにはファイル名の拡張子を含める必要があります。既定の拡張子は想定されません。

lpApplicationName パラメーターには NULL を指定できます。その場合、モジュール名は lpCommandLine 文字列内で最初の空白文字で区切られたトークンでなければなりません。スペースを含む長いファイル名を使用する場合は、ファイル名の終わりと引数の始まりを示すために引用符で囲んだ文字列を使用してください。そうしないと、ファイル名があいまいになります。たとえば、文字列 "c:\program files\sub dir\program name" を考えてみます。この文字列はいくつかの方法で解釈できます。システムは次の順序で可能性を解釈しようとします:

c:\program.exe c:\program files\sub.exe c:\program files\sub dir\program.exe c:\program files\sub dir\program name.exe 実行可能モジュールが 16 ビットアプリケーションの場合、lpApplicationNameNULL にし、lpCommandLine が指す文字列で実行可能モジュールとその引数を指定する必要があります。既定では、 CreateProcessAsUser によって作成されるすべての 16 ビット Windows ベースアプリケーションは、別個の VDM で実行されます( CreateProcessCREATE_SEPARATE_WOW_VDM と同等)。

lpCommandLineLPWSTRinoutoptional

実行するコマンドラインです。この文字列の最大長は 32K 文字です。lpApplicationNameNULL の場合、lpCommandLine のモジュール名部分は MAX_PATH 文字に制限されます。

この関数の Unicode バージョンである CreateProcessAsUserW は、この文字列の内容を変更することがあります。したがって、このパラメーターは読み取り専用メモリ(const 変数やリテラル文字列など)へのポインターにすることはできません。このパラメーターが定数文字列の場合、関数がアクセス違反を引き起こす可能性があります。

lpCommandLine パラメーターには NULL を指定できます。その場合、関数は lpApplicationName が指す文字列をコマンドラインとして使用します。

lpApplicationNamelpCommandLine の両方が非 NULL の場合、lpApplicationName が実行するモジュールを指定し、lpCommandLine がコマンドラインを指定します。新しいプロセスは GetCommandLine を使用してコマンドライン全体を取得できます。C で書かれたコンソールプロセスは、argc および argv 引数を使用してコマンドラインを解析できます。argv[0] はモジュール名であるため、C プログラマーは一般にコマンドラインの最初のトークンとしてモジュール名を繰り返します。

lpApplicationNameNULL の場合、コマンドラインで最初に空白文字で区切られたトークンがモジュール名を指定します。スペースを含む長いファイル名を使用する場合は、ファイル名の終わりと引数の始まりを示すために引用符で囲んだ文字列を使用してください(lpApplicationName パラメーターの説明を参照)。ファイル名に拡張子が含まれていない場合は、.exe が付加されます。したがって、ファイル名の拡張子が .com の場合は、このパラメーターに .com 拡張子を含める必要があります。ファイル名が拡張子なしのピリオド (.) で終わる場合、またはファイル名にパスが含まれている場合は、.exe は付加されません。ファイル名にディレクトリパスが含まれていない場合、システムは次の順序で実行可能ファイルを検索します:

  1. アプリケーションが読み込まれたディレクトリ。
  2. 親プロセスの現在のディレクトリ。
  3. 32 ビット Windows システムディレクトリ。このディレクトリのパスを取得するには、GetSystemDirectory 関数を使用します。
  4. 16 ビット Windows システムディレクトリ。このディレクトリのパスを取得する関数はありませんが、検索の対象になります。
  5. Windows ディレクトリ。このディレクトリのパスを取得するには、 GetWindowsDirectory 関数を使用します。
  6. PATH 環境変数に列挙されているディレクトリ。なお、この関数は App Paths レジストリキーで指定されるアプリケーションごとのパスは検索しません。このアプリケーションごとのパスを検索シーケンスに含めるには、ShellExecute 関数を使用します。
システムは、ファイル名を引数から分離するために、コマンドライン文字列に null 文字を追加します。これにより、内部処理のために元の文字列が 2 つの文字列に分割されます。
lpProcessAttributesSECURITY_ATTRIBUTES*inoptional新しいプロセスオブジェクトのセキュリティ記述子を指定し、返されるプロセスへのハンドルを子プロセスが継承できるかどうかを決定する SECURITY_ATTRIBUTES 構造体へのポインターです。lpProcessAttributesNULL の場合、または lpSecurityDescriptorNULL の場合、プロセスには既定のセキュリティ記述子が割り当てられ、ハンドルは継承できません。既定のセキュリティ記述子は、hToken パラメーターで参照されるユーザーのものです。このセキュリティ記述子は呼び出し元にアクセスを許可しない場合があり、その場合、プロセスは実行後に再度開くことができないことがあります。プロセスハンドルは有効であり、引き続きすべてのアクセス権を持ちます。
lpThreadAttributesSECURITY_ATTRIBUTES*inoptional新しいスレッドオブジェクトのセキュリティ記述子を指定し、返されるスレッドへのハンドルを子プロセスが継承できるかどうかを決定する SECURITY_ATTRIBUTES 構造体へのポインターです。lpThreadAttributesNULL の場合、または lpSecurityDescriptorNULL の場合、スレッドには既定のセキュリティ記述子が割り当てられ、ハンドルは継承できません。既定のセキュリティ記述子は、hToken パラメーターで参照されるユーザーのものです。このセキュリティ記述子は呼び出し元にアクセスを許可しない場合があります。
bInheritHandlesBOOLin

このパラメーターが TRUE の場合、呼び出し元プロセス内の継承可能な各ハンドルが新しいプロセスによって継承されます。このパラメーターが FALSE の場合、ハンドルは継承されません。継承されたハンドルは、元のハンドルと同じ値とアクセス権を持つことに注意してください。 継承可能なハンドルについての追加の説明は、「解説」を参照してください。

ターミナルサービス: セッションをまたいでハンドルを継承することはできません。さらに、このパラメーターが TRUE の場合は、呼び出し元と同じセッション内でプロセスを作成する必要があります。

Protected Process Light (PPL) プロセス: PPL プロセスが非 PPL プロセスを作成する場合、非 PPL プロセスから PPL プロセスへの PROCESS_DUP_HANDLE は許可されないため、汎用ハンドル継承はブロックされます。Process Security and Access Rights を参照してください。

dwCreationFlagsPROCESS_CREATION_FLAGSin

優先順位クラスとプロセスの作成を制御するフラグです。値の一覧については、 Process Creation Flags を参照してください。

このパラメーターは、新しいプロセスの優先順位クラスも制御します。優先順位クラスは、プロセスのスレッドのスケジューリング優先順位を決定するために使用されます。値の一覧については、 GetPriorityClass を参照してください。優先順位クラスフラグがいずれも指定されていない場合、作成元プロセスの優先順位クラスが IDLE_PRIORITY_CLASS または BELOW_NORMAL_PRIORITY_CLASS でない限り、優先順位クラスは既定で NORMAL_PRIORITY_CLASS になります。これらの場合、子プロセスは呼び出し元プロセスの既定の優先順位クラスを受け取ります。

dwCreationFlags パラメーターの値が 0 の場合:

  • プロセスは、呼び出し元のエラーモードと親のコンソールの両方を継承します。
  • 新しいプロセスの環境ブロックは ANSI 文字を含むものとみなされます(追加情報は lpEnvironment パラメーターを参照)。
  • 16 ビット Windows ベースアプリケーションは、共有 Virtual DOS マシン (VDM) で実行されます。
lpEnvironmentvoid*inoptional

新しいプロセスの環境ブロックへのポインターです。このパラメーターが NULL の場合、新しいプロセスは呼び出し元プロセスの環境を使用します。

環境ブロックは、null で終了する文字列を null で終了させたブロックで構成されます。各文字列は次の形式です:

name=value\0

等号は区切り文字として使用されるため、環境変数の名前には使用できません。

環境ブロックには Unicode 文字または ANSI 文字を含めることができます。lpEnvironment が指す環境ブロックに Unicode 文字が含まれている場合は、dwCreationFlagsCREATE_UNICODE_ENVIRONMENT を含めるようにしてください。

この関数の ANSI バージョンである CreateProcessAsUserA は、プロセスの環境ブロックの合計サイズが 32,767 文字を超える場合に失敗します。

なお、ANSI 環境ブロックは 2 つのゼロバイトで終了します(最後の文字列用に 1 つ、ブロックの終端用にもう 1 つ)。Unicode 環境ブロックは 4 つのゼロバイトで終了します(最後の文字列用に 2 つ、ブロックの終端用にもう 2 つ)。

Windows Server 2003 および Windows XP: ユーザー環境変数とシステム環境変数を合わせたサイズが 8192 バイトを超える場合、CreateProcessAsUser によって作成されたプロセスは、親プロセスから関数に渡された環境ブロックでは実行されなくなります。代わりに、子プロセスは CreateEnvironmentBlock 関数によって返された環境ブロックで実行されます。

指定したユーザーの環境ブロックのコピーを取得するには、 CreateEnvironmentBlock 関数を使用します。

lpCurrentDirectoryLPCWSTRinoptional

プロセスの現在のディレクトリへのフルパスです。この文字列には UNC パスを指定することもできます。

このパラメーターが NULL の場合、新しいプロセスは呼び出し元プロセスと同じ現在のドライブおよびディレクトリを持ちます。(この機能は主に、アプリケーションを起動して初期ドライブと作業ディレクトリを指定する必要があるシェルのために提供されています。)

lpStartupInfoSTARTUPINFOW*in

STARTUPINFO または STARTUPINFOEX 構造体へのポインターです。

ユーザーは、指定したウィンドウステーションとデスクトップの両方に対してフルアクセス権を持っている必要があります。プロセスを対話型にしたい場合は、winsta0\default を指定します。lpDesktop メンバーが NULL の場合、新しいプロセスは親プロセスのデスクトップとウィンドウステーションを継承します。 このメンバーが空文字列 "" の場合、新しいプロセスは Process Connection to a Window Station で説明されているルールを使用してウィンドウステーションに接続します。

拡張属性を設定するには、STARTUPINFOEX 構造体を使用し、dwCreationFlags パラメーターに EXTENDED_STARTUPINFO_PRESENT を指定します。

STARTUPINFO または STARTUPINFOEX 内のハンドルは、不要になったときに CloseHandle で閉じる必要があります。

重要 STARTUPINFO の標準ハンドルフィールドが有効なハンドル値を含んでいることを保証するのは、呼び出し元の責任です。これらのフィールドは、dwFlags メンバーが STARTF_USESTDHANDLES を指定している場合でも、検証されることなくそのまま子プロセスにコピーされます。不正な値は子プロセスの誤動作やクラッシュを引き起こす可能性があります。無効なハンドルを検出するには、Application Verifier ランタイム検証ツールを使用してください。
lpProcessInformationPROCESS_INFORMATION*out

新しいプロセスに関する識別情報を受け取る PROCESS_INFORMATION 構造体へのポインターです。

PROCESS_INFORMATION 内のハンドルは、不要になったときに CloseHandle で閉じる必要があります。

戻り値の型: BOOL

公式ドキュメント

新しいプロセスとそのプライマリスレッドを作成します。新しいプロセスは、指定したトークンが表すユーザーのセキュリティコンテキストで実行されます。(Unicode)

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、 GetLastError を呼び出します。

なお、この関数はプロセスの初期化が完了する前に戻ることに注意してください。必要な DLL が見つからない場合や初期化に失敗した場合、プロセスは終了します。プロセスの終了ステータスを取得するには、GetExitCodeProcess を呼び出します。

解説(Remarks)

CreateProcessAsUser は、呼び出し元プロセスのプライマリトークンを TOKEN_DUPLICATE および TOKEN_IMPERSONATE アクセス権で開くことができる必要があります。

既定では、 CreateProcessAsUser は、表示されずユーザー入力を受け取れないデスクトップを持つ非対話型のウィンドウステーション上に新しいプロセスを作成します。新しいプロセスとのユーザー対話を有効にするには、 STARTUPINFO 構造体の lpDesktop メンバーに、既定の対話型ウィンドウステーションとデスクトップの名前 "winsta0\default" を指定する必要があります。さらに、 CreateProcessAsUser を呼び出す前に、既定の対話型ウィンドウステーションと既定のデスクトップの両方の任意アクセス制御リスト (DACL) を変更する必要があります。ウィンドウステーションとデスクトップの DACL は、hToken パラメーターで表されるユーザーまたはログオンセッションにアクセスを許可する必要があります。

CreateProcessAsUser は、指定したユーザーのプロファイルを HKEY_USERS レジストリキーに読み込みません。したがって、HKEY_CURRENT_USER レジストリキー内の情報にアクセスするには、 CreateProcessAsUser を呼び出す前に、 LoadUserProfile 関数を使用してユーザーのプロファイル情報を HKEY_USERS に読み込む必要があります。新しいプロセスが終了した後は、必ず UnloadUserProfile を呼び出してください。

lpEnvironment パラメーターが NULL の場合、新しいプロセスは呼び出し元プロセスの環境を継承します。 CreateProcessAsUser は、hToken で表されるユーザーに固有の環境変数を含めるように環境ブロックを自動的に変更することはありません。たとえば、lpEnvironment が NULL の場合、USERNAME および USERDOMAIN 変数は呼び出し元プロセスから継承されます。新しいプロセスのために環境ブロックを準備し、lpEnvironment に指定するのは、ご自身の責任です。

CreateProcessWithLogonW 関数と CreateProcessWithTokenW 関数は CreateProcessAsUser に似ていますが、呼び出し元がユーザーを認証してトークンを取得するために LogonUser 関数を呼び出す必要がない点が異なります。

CreateProcessAsUser では、呼び出し元または対象ユーザーのセキュリティコンテキストで、指定したディレクトリと実行可能イメージにアクセスできます。既定では、 CreateProcessAsUser は呼び出し元のセキュリティコンテキストでディレクトリと実行可能イメージにアクセスします。この場合、呼び出し元がディレクトリと実行可能イメージにアクセスできないと、関数は失敗します。対象ユーザーのセキュリティコンテキストを使用してディレクトリと実行可能イメージにアクセスするには、 CreateProcessAsUser を呼び出す前に、hToken を指定して ImpersonateLoggedOnUser 関数を呼び出します。

プロセスにはプロセス識別子が割り当てられます。識別子はプロセスが終了するまで有効です。これはプロセスの識別に使用したり、 OpenProcess 関数に指定してプロセスへのハンドルを開いたりするために使用できます。プロセス内の最初のスレッドにもスレッド識別子が割り当てられます。これは OpenThread 関数に指定してスレッドへのハンドルを開くために使用できます。識別子はスレッドが終了するまで有効で、システム内でスレッドを一意に識別するために使用できます。これらの識別子は PROCESS_INFORMATION 構造体に返されます。

呼び出し元スレッドは WaitForInputIdle 関数を使用して、新しいプロセスが初期化を完了し、保留中の入力がない状態でユーザー入力を待機するまで待つことができます。 CreateProcessAsUser は新しいプロセスが初期化を完了するのを待たずに戻るため、これは親プロセスと子プロセス間の同期に役立つことがあります。たとえば、作成元プロセスは新しいプロセスに関連付けられたウィンドウを探そうとする前に WaitForInputIdle を使用できます。

プロセスをシャットダウンする推奨される方法は、 ExitProcess 関数を使用することです。この関数は、プロセスにアタッチされているすべての DLL に終了が近づいていることの通知を送信するためです。プロセスをシャットダウンするその他の手段では、アタッチされている DLL に通知されません。スレッドが ExitProcess を呼び出すと、プロセスの他のスレッドは(アタッチされた DLL のスレッド終了コードを含む)追加コードを実行する機会なく終了することに注意してください。詳細については、 Terminating a Process を参照してください。

既定では、bInheritHandles パラメーターの値として TRUE を渡すと、すべての継承可能なハンドルが新しいプロセスによって継承されます。 これは、複数のスレッドから同時にプロセスを作成しながら、各プロセスに異なるハンドルを継承させたいアプリケーションにとっては問題になることがあります。 アプリケーションは、 UpdateProcThreadAttributeList 関数を PROC_THREAD_ATTRIBUTE_HANDLE_LIST パラメーターとともに使用して、特定のプロセスに継承させるハンドルのリストを指定できます。

セキュリティに関する解説

lpApplicationName パラメーターには NULL を指定できますが、その場合、実行可能ファイル名は lpCommandLine 内で最初に空白文字で区切られた文字列でなければなりません。実行可能ファイルまたはパス名にスペースが含まれている場合、関数のスペースの解析方法により、別の実行可能ファイルが実行されるリスクがあります。次の例は危険です。"MyApp.exe" の代わりに、"Program.exe" が存在すれば関数がそれを実行しようとするためです。
    LPTSTR szCmdline[] = _tcsdup(TEXT("C:\\Program Files\\MyApp"));
    CreateProcessAsUser(hToken, NULL, szCmdline, /*...*/ );

悪意のあるユーザーがシステム上に "Program.exe" というアプリケーションを作成した場合、Program Files ディレクトリを使用して CreateProcessAsUser を誤って呼び出すプログラムは、意図したアプリケーションの代わりにこのアプリケーションを実行します。

この問題を回避するには、lpApplicationName に NULL を渡さないでください。lpApplicationNameNULL を渡す場合は、次の例に示すように、lpCommandLine 内の実行可能ファイルのパスを引用符で囲んでください。

    LPTSTR szCmdline[] = _tcsdup(TEXT("\"C:\\Program Files\\MyApp\""));
    CreateProcessAsUser(hToken, NULL, szCmdline, /*...*/);

PowerShell: CreateProcessAsUser 関数を使用して PowerShell バージョン 2.0 でコマンドレットを実装すると、コマンドレットはファンインおよびファンアウトの両方のリモートセッションで正しく動作します。ただし、特定のセキュリティシナリオのため、CreateProcessAsUser で実装されたコマンドレットは、PowerShell バージョン 3.0 ではファンインのリモートセッションでのみ正しく動作します。ファンアウトのリモートセッションは、クライアントのセキュリティ特権が不十分なため失敗します。PowerShell バージョン 3.0 でファンインとファンアウトの両方のリモートセッションで動作するコマンドレットを実装するには、CreateProcess 関数を使用してください。

例については、 Starting an Interactive Client Process を参照してください。

メモ

processthreadsapi.h ヘッダーは、CreateProcessAsUser を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義します。エンコーディング中立のエイリアスの使用を、エンコーディング中立でないコードと混在させると、コンパイルエラーやランタイムエラーを引き起こす不一致につながる可能性があります。詳細については、Conventions for Function Prototypes を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// ADVAPI32.dll  (Unicode / -W)
#include <windows.h>

BOOL CreateProcessAsUserW(
    HANDLE hToken,   // optional
    LPCWSTR lpApplicationName,   // optional
    LPWSTR lpCommandLine,   // optional
    SECURITY_ATTRIBUTES* lpProcessAttributes,   // optional
    SECURITY_ATTRIBUTES* lpThreadAttributes,   // optional
    BOOL bInheritHandles,
    PROCESS_CREATION_FLAGS dwCreationFlags,
    void* lpEnvironment,   // optional
    LPCWSTR lpCurrentDirectory,   // optional
    STARTUPINFOW* lpStartupInfo,
    PROCESS_INFORMATION* lpProcessInformation
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", CharSet = CharSet.Unicode, SetLastError = true, ExactSpelling = true)]
static extern bool CreateProcessAsUserW(
    IntPtr hToken,   // HANDLE optional
    [MarshalAs(UnmanagedType.LPWStr)] string lpApplicationName,   // LPCWSTR optional
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder lpCommandLine,   // LPWSTR optional, in/out
    IntPtr lpProcessAttributes,   // SECURITY_ATTRIBUTES* optional
    IntPtr lpThreadAttributes,   // SECURITY_ATTRIBUTES* optional
    bool bInheritHandles,   // BOOL
    uint dwCreationFlags,   // PROCESS_CREATION_FLAGS
    IntPtr lpEnvironment,   // void* optional
    [MarshalAs(UnmanagedType.LPWStr)] string lpCurrentDirectory,   // LPCWSTR optional
    IntPtr lpStartupInfo,   // STARTUPINFOW*
    IntPtr lpProcessInformation   // PROCESS_INFORMATION* out
);
<DllImport("ADVAPI32.dll", CharSet:=CharSet.Unicode, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CreateProcessAsUserW(
    hToken As IntPtr,   ' HANDLE optional
    <MarshalAs(UnmanagedType.LPWStr)> lpApplicationName As String,   ' LPCWSTR optional
    <MarshalAs(UnmanagedType.LPWStr)> lpCommandLine As System.Text.StringBuilder,   ' LPWSTR optional, in/out
    lpProcessAttributes As IntPtr,   ' SECURITY_ATTRIBUTES* optional
    lpThreadAttributes As IntPtr,   ' SECURITY_ATTRIBUTES* optional
    bInheritHandles As Boolean,   ' BOOL
    dwCreationFlags As UInteger,   ' PROCESS_CREATION_FLAGS
    lpEnvironment As IntPtr,   ' void* optional
    <MarshalAs(UnmanagedType.LPWStr)> lpCurrentDirectory As String,   ' LPCWSTR optional
    lpStartupInfo As IntPtr,   ' STARTUPINFOW*
    lpProcessInformation As IntPtr   ' PROCESS_INFORMATION* out
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function
' hToken : HANDLE optional
' lpApplicationName : LPCWSTR optional
' lpCommandLine : LPWSTR optional, in/out
' lpProcessAttributes : SECURITY_ATTRIBUTES* optional
' lpThreadAttributes : SECURITY_ATTRIBUTES* optional
' bInheritHandles : BOOL
' dwCreationFlags : PROCESS_CREATION_FLAGS
' lpEnvironment : void* optional
' lpCurrentDirectory : LPCWSTR optional
' lpStartupInfo : STARTUPINFOW*
' lpProcessInformation : PROCESS_INFORMATION* out
Declare PtrSafe Function CreateProcessAsUserW Lib "advapi32" ( _
    ByVal hToken As LongPtr, _
    ByVal lpApplicationName As LongPtr, _
    ByVal lpCommandLine As LongPtr, _
    ByVal lpProcessAttributes As LongPtr, _
    ByVal lpThreadAttributes As LongPtr, _
    ByVal bInheritHandles As Long, _
    ByVal dwCreationFlags As Long, _
    ByVal lpEnvironment As LongPtr, _
    ByVal lpCurrentDirectory As LongPtr, _
    ByVal lpStartupInfo As LongPtr, _
    ByVal lpProcessInformation As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CreateProcessAsUserW = ctypes.windll.advapi32.CreateProcessAsUserW
CreateProcessAsUserW.restype = wintypes.BOOL
CreateProcessAsUserW.argtypes = [
    wintypes.HANDLE,  # hToken : HANDLE optional
    wintypes.LPCWSTR,  # lpApplicationName : LPCWSTR optional
    wintypes.LPWSTR,  # lpCommandLine : LPWSTR optional, in/out
    ctypes.c_void_p,  # lpProcessAttributes : SECURITY_ATTRIBUTES* optional
    ctypes.c_void_p,  # lpThreadAttributes : SECURITY_ATTRIBUTES* optional
    wintypes.BOOL,  # bInheritHandles : BOOL
    wintypes.DWORD,  # dwCreationFlags : PROCESS_CREATION_FLAGS
    ctypes.POINTER(None),  # lpEnvironment : void* optional
    wintypes.LPCWSTR,  # lpCurrentDirectory : LPCWSTR optional
    ctypes.c_void_p,  # lpStartupInfo : STARTUPINFOW*
    ctypes.c_void_p,  # lpProcessInformation : PROCESS_INFORMATION* out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
CreateProcessAsUserW = Fiddle::Function.new(
  lib['CreateProcessAsUserW'],
  [
    Fiddle::TYPE_VOIDP,  # hToken : HANDLE optional
    Fiddle::TYPE_VOIDP,  # lpApplicationName : LPCWSTR optional
    Fiddle::TYPE_VOIDP,  # lpCommandLine : LPWSTR optional, in/out
    Fiddle::TYPE_VOIDP,  # lpProcessAttributes : SECURITY_ATTRIBUTES* optional
    Fiddle::TYPE_VOIDP,  # lpThreadAttributes : SECURITY_ATTRIBUTES* optional
    Fiddle::TYPE_INT,  # bInheritHandles : BOOL
    -Fiddle::TYPE_INT,  # dwCreationFlags : PROCESS_CREATION_FLAGS
    Fiddle::TYPE_VOIDP,  # lpEnvironment : void* optional
    Fiddle::TYPE_VOIDP,  # lpCurrentDirectory : LPCWSTR optional
    Fiddle::TYPE_VOIDP,  # lpStartupInfo : STARTUPINFOW*
    Fiddle::TYPE_VOIDP,  # lpProcessInformation : PROCESS_INFORMATION* out
  ],
  Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"
#[link(name = "advapi32")]
extern "system" {
    fn CreateProcessAsUserW(
        hToken: *mut core::ffi::c_void,  // HANDLE optional
        lpApplicationName: *const u16,  // LPCWSTR optional
        lpCommandLine: *mut u16,  // LPWSTR optional, in/out
        lpProcessAttributes: *mut SECURITY_ATTRIBUTES,  // SECURITY_ATTRIBUTES* optional
        lpThreadAttributes: *mut SECURITY_ATTRIBUTES,  // SECURITY_ATTRIBUTES* optional
        bInheritHandles: i32,  // BOOL
        dwCreationFlags: u32,  // PROCESS_CREATION_FLAGS
        lpEnvironment: *mut (),  // void* optional
        lpCurrentDirectory: *const u16,  // LPCWSTR optional
        lpStartupInfo: *mut STARTUPINFOW,  // STARTUPINFOW*
        lpProcessInformation: *mut PROCESS_INFORMATION  // PROCESS_INFORMATION* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
public static extern bool CreateProcessAsUserW(IntPtr hToken, [MarshalAs(UnmanagedType.LPWStr)] string lpApplicationName, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder lpCommandLine, IntPtr lpProcessAttributes, IntPtr lpThreadAttributes, bool bInheritHandles, uint dwCreationFlags, IntPtr lpEnvironment, [MarshalAs(UnmanagedType.LPWStr)] string lpCurrentDirectory, IntPtr lpStartupInfo, IntPtr lpProcessInformation);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_CreateProcessAsUserW' -Namespace Win32 -PassThru
# $api::CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
#uselib "ADVAPI32.dll"
#func global CreateProcessAsUserW "CreateProcessAsUserW" wptr, wptr, wptr, wptr, wptr, wptr, wptr, wptr, wptr, wptr, wptr
; CreateProcessAsUserW hToken, lpApplicationName, varptr(lpCommandLine), varptr(lpProcessAttributes), varptr(lpThreadAttributes), bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, varptr(lpStartupInfo), varptr(lpProcessInformation)   ; 戻り値は stat
; hToken : HANDLE optional -> "wptr"
; lpApplicationName : LPCWSTR optional -> "wptr"
; lpCommandLine : LPWSTR optional, in/out -> "wptr"
; lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> "wptr"
; lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> "wptr"
; bInheritHandles : BOOL -> "wptr"
; dwCreationFlags : PROCESS_CREATION_FLAGS -> "wptr"
; lpEnvironment : void* optional -> "wptr"
; lpCurrentDirectory : LPCWSTR optional -> "wptr"
; lpStartupInfo : STARTUPINFOW* -> "wptr"
; lpProcessInformation : PROCESS_INFORMATION* out -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "ADVAPI32.dll"
#cfunc global CreateProcessAsUserW "CreateProcessAsUserW" sptr, wstr, var, var, var, int, int, sptr, wstr, var, var
; res = CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
; hToken : HANDLE optional -> "sptr"
; lpApplicationName : LPCWSTR optional -> "wstr"
; lpCommandLine : LPWSTR optional, in/out -> "var"
; lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> "var"
; lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> "var"
; bInheritHandles : BOOL -> "int"
; dwCreationFlags : PROCESS_CREATION_FLAGS -> "int"
; lpEnvironment : void* optional -> "sptr"
; lpCurrentDirectory : LPCWSTR optional -> "wstr"
; lpStartupInfo : STARTUPINFOW* -> "var"
; lpProcessInformation : PROCESS_INFORMATION* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; BOOL CreateProcessAsUserW(HANDLE hToken, LPCWSTR lpApplicationName, LPWSTR lpCommandLine, SECURITY_ATTRIBUTES* lpProcessAttributes, SECURITY_ATTRIBUTES* lpThreadAttributes, BOOL bInheritHandles, PROCESS_CREATION_FLAGS dwCreationFlags, void* lpEnvironment, LPCWSTR lpCurrentDirectory, STARTUPINFOW* lpStartupInfo, PROCESS_INFORMATION* lpProcessInformation)
#uselib "ADVAPI32.dll"
#cfunc global CreateProcessAsUserW "CreateProcessAsUserW" intptr, wstr, var, var, var, int, int, intptr, wstr, var, var
; res = CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
; hToken : HANDLE optional -> "intptr"
; lpApplicationName : LPCWSTR optional -> "wstr"
; lpCommandLine : LPWSTR optional, in/out -> "var"
; lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> "var"
; lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> "var"
; bInheritHandles : BOOL -> "int"
; dwCreationFlags : PROCESS_CREATION_FLAGS -> "int"
; lpEnvironment : void* optional -> "intptr"
; lpCurrentDirectory : LPCWSTR optional -> "wstr"
; lpStartupInfo : STARTUPINFOW* -> "var"
; lpProcessInformation : PROCESS_INFORMATION* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	advapi32 = windows.NewLazySystemDLL("ADVAPI32.dll")
	procCreateProcessAsUserW = advapi32.NewProc("CreateProcessAsUserW")
)

// hToken (HANDLE optional), lpApplicationName (LPCWSTR optional), lpCommandLine (LPWSTR optional, in/out), lpProcessAttributes (SECURITY_ATTRIBUTES* optional), lpThreadAttributes (SECURITY_ATTRIBUTES* optional), bInheritHandles (BOOL), dwCreationFlags (PROCESS_CREATION_FLAGS), lpEnvironment (void* optional), lpCurrentDirectory (LPCWSTR optional), lpStartupInfo (STARTUPINFOW*), lpProcessInformation (PROCESS_INFORMATION* out)
r1, _, err := procCreateProcessAsUserW.Call(
	uintptr(hToken),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpApplicationName))),
	uintptr(lpCommandLine),
	uintptr(lpProcessAttributes),
	uintptr(lpThreadAttributes),
	uintptr(bInheritHandles),
	uintptr(dwCreationFlags),
	uintptr(lpEnvironment),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpCurrentDirectory))),
	uintptr(lpStartupInfo),
	uintptr(lpProcessInformation),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function CreateProcessAsUserW(
  hToken: THandle;   // HANDLE optional
  lpApplicationName: PWideChar;   // LPCWSTR optional
  lpCommandLine: PWideChar;   // LPWSTR optional, in/out
  lpProcessAttributes: Pointer;   // SECURITY_ATTRIBUTES* optional
  lpThreadAttributes: Pointer;   // SECURITY_ATTRIBUTES* optional
  bInheritHandles: BOOL;   // BOOL
  dwCreationFlags: DWORD;   // PROCESS_CREATION_FLAGS
  lpEnvironment: Pointer;   // void* optional
  lpCurrentDirectory: PWideChar;   // LPCWSTR optional
  lpStartupInfo: Pointer;   // STARTUPINFOW*
  lpProcessInformation: Pointer   // PROCESS_INFORMATION* out
): BOOL; stdcall;
  external 'ADVAPI32.dll' name 'CreateProcessAsUserW';
result := DllCall("ADVAPI32\CreateProcessAsUserW"
    , "Ptr", hToken   ; HANDLE optional
    , "WStr", lpApplicationName   ; LPCWSTR optional
    , "Ptr", lpCommandLine   ; LPWSTR optional, in/out
    , "Ptr", lpProcessAttributes   ; SECURITY_ATTRIBUTES* optional
    , "Ptr", lpThreadAttributes   ; SECURITY_ATTRIBUTES* optional
    , "Int", bInheritHandles   ; BOOL
    , "UInt", dwCreationFlags   ; PROCESS_CREATION_FLAGS
    , "Ptr", lpEnvironment   ; void* optional
    , "WStr", lpCurrentDirectory   ; LPCWSTR optional
    , "Ptr", lpStartupInfo   ; STARTUPINFOW*
    , "Ptr", lpProcessInformation   ; PROCESS_INFORMATION* out
    , "Int")   ; return: BOOL
●CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation) = DLL("ADVAPI32.dll", "bool CreateProcessAsUserW(void*, char*, char*, void*, void*, bool, dword, void*, char*, void*, void*)")
# 呼び出し: CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
# hToken : HANDLE optional -> "void*"
# lpApplicationName : LPCWSTR optional -> "char*"
# lpCommandLine : LPWSTR optional, in/out -> "char*"
# lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> "void*"
# lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> "void*"
# bInheritHandles : BOOL -> "bool"
# dwCreationFlags : PROCESS_CREATION_FLAGS -> "dword"
# lpEnvironment : void* optional -> "void*"
# lpCurrentDirectory : LPCWSTR optional -> "char*"
# lpStartupInfo : STARTUPINFOW* -> "void*"
# lpProcessInformation : PROCESS_INFORMATION* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。
const std = @import("std");

extern "advapi32" fn CreateProcessAsUserW(
    hToken: ?*anyopaque, // HANDLE optional
    lpApplicationName: [*c]const u16, // LPCWSTR optional
    lpCommandLine: [*c]u16, // LPWSTR optional, in/out
    lpProcessAttributes: [*c]SECURITY_ATTRIBUTES, // SECURITY_ATTRIBUTES* optional
    lpThreadAttributes: [*c]SECURITY_ATTRIBUTES, // SECURITY_ATTRIBUTES* optional
    bInheritHandles: i32, // BOOL
    dwCreationFlags: u32, // PROCESS_CREATION_FLAGS
    lpEnvironment: ?*anyopaque, // void* optional
    lpCurrentDirectory: [*c]const u16, // LPCWSTR optional
    lpStartupInfo: [*c]STARTUPINFOW, // STARTUPINFOW*
    lpProcessInformation: [*c]PROCESS_INFORMATION // PROCESS_INFORMATION* out
) callconv(std.os.windows.WINAPI) i32;
// Unicode(-W): UTF-16LE のヌル終端バッファ([*c]const u16)を渡す。
proc CreateProcessAsUserW(
    hToken: pointer,  # HANDLE optional
    lpApplicationName: WideCString,  # LPCWSTR optional
    lpCommandLine: ptr uint16,  # LPWSTR optional, in/out
    lpProcessAttributes: ptr SECURITY_ATTRIBUTES,  # SECURITY_ATTRIBUTES* optional
    lpThreadAttributes: ptr SECURITY_ATTRIBUTES,  # SECURITY_ATTRIBUTES* optional
    bInheritHandles: int32,  # BOOL
    dwCreationFlags: uint32,  # PROCESS_CREATION_FLAGS
    lpEnvironment: pointer,  # void* optional
    lpCurrentDirectory: WideCString,  # LPCWSTR optional
    lpStartupInfo: ptr STARTUPINFOW,  # STARTUPINFOW*
    lpProcessInformation: ptr PROCESS_INFORMATION  # PROCESS_INFORMATION* out
): int32 {.importc: "CreateProcessAsUserW", stdcall, dynlib: "ADVAPI32.dll".}
# Unicode(-W): WideCString は newWideCString("...") で生成。
pragma(lib, "advapi32");
extern(Windows)
int CreateProcessAsUserW(
    void* hToken,   // HANDLE optional
    const(wchar)* lpApplicationName,   // LPCWSTR optional
    wchar* lpCommandLine,   // LPWSTR optional, in/out
    SECURITY_ATTRIBUTES* lpProcessAttributes,   // SECURITY_ATTRIBUTES* optional
    SECURITY_ATTRIBUTES* lpThreadAttributes,   // SECURITY_ATTRIBUTES* optional
    int bInheritHandles,   // BOOL
    uint dwCreationFlags,   // PROCESS_CREATION_FLAGS
    void* lpEnvironment,   // void* optional
    const(wchar)* lpCurrentDirectory,   // LPCWSTR optional
    STARTUPINFOW* lpStartupInfo,   // STARTUPINFOW*
    PROCESS_INFORMATION* lpProcessInformation   // PROCESS_INFORMATION* out
);
ccall((:CreateProcessAsUserW, "ADVAPI32.dll"), stdcall, Int32,
      (Ptr{Cvoid}, Cwstring, Ptr{UInt16}, Ptr{SECURITY_ATTRIBUTES}, Ptr{SECURITY_ATTRIBUTES}, Int32, UInt32, Ptr{Cvoid}, Cwstring, Ptr{STARTUPINFOW}, Ptr{PROCESS_INFORMATION}),
      hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
# hToken : HANDLE optional -> Ptr{Cvoid}
# lpApplicationName : LPCWSTR optional -> Cwstring
# lpCommandLine : LPWSTR optional, in/out -> Ptr{UInt16}
# lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> Ptr{SECURITY_ATTRIBUTES}
# lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> Ptr{SECURITY_ATTRIBUTES}
# bInheritHandles : BOOL -> Int32
# dwCreationFlags : PROCESS_CREATION_FLAGS -> UInt32
# lpEnvironment : void* optional -> Ptr{Cvoid}
# lpCurrentDirectory : LPCWSTR optional -> Cwstring
# lpStartupInfo : STARTUPINFOW* -> Ptr{STARTUPINFOW}
# lpProcessInformation : PROCESS_INFORMATION* out -> Ptr{PROCESS_INFORMATION}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
# Unicode(-W): Cwstring には transcode(UInt16, "...") 等で UTF-16 を渡す。
local ffi = require("ffi")
ffi.cdef[[
int32_t CreateProcessAsUserW(
    void* hToken,
    const uint16_t* lpApplicationName,
    uint16_t* lpCommandLine,
    void* lpProcessAttributes,
    void* lpThreadAttributes,
    int32_t bInheritHandles,
    uint32_t dwCreationFlags,
    void* lpEnvironment,
    const uint16_t* lpCurrentDirectory,
    void* lpStartupInfo,
    void* lpProcessInformation);
]]
local advapi32 = ffi.load("advapi32")
-- advapi32.CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
-- hToken : HANDLE optional
-- lpApplicationName : LPCWSTR optional
-- lpCommandLine : LPWSTR optional, in/out
-- lpProcessAttributes : SECURITY_ATTRIBUTES* optional
-- lpThreadAttributes : SECURITY_ATTRIBUTES* optional
-- bInheritHandles : BOOL
-- dwCreationFlags : PROCESS_CREATION_FLAGS
-- lpEnvironment : void* optional
-- lpCurrentDirectory : LPCWSTR optional
-- lpStartupInfo : STARTUPINFOW*
-- lpProcessInformation : PROCESS_INFORMATION* out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
-- Unicode(-W): uint16_t* には UTF-16LE のバッファ(ffi.new("uint16_t[?]", ...))を渡す。
const koffi = require('koffi');
const lib = koffi.load('ADVAPI32.dll');
const CreateProcessAsUserW = lib.func('__stdcall', 'CreateProcessAsUserW', 'int32_t', ['void *', 'str16', 'uint16_t *', 'void *', 'void *', 'int32_t', 'uint32_t', 'void *', 'str16', 'void *', 'void *']);
// CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
// hToken : HANDLE optional -> 'void *'
// lpApplicationName : LPCWSTR optional -> 'str16'
// lpCommandLine : LPWSTR optional, in/out -> 'uint16_t *'
// lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> 'void *'
// lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> 'void *'
// bInheritHandles : BOOL -> 'int32_t'
// dwCreationFlags : PROCESS_CREATION_FLAGS -> 'uint32_t'
// lpEnvironment : void* optional -> 'void *'
// lpCurrentDirectory : LPCWSTR optional -> 'str16'
// lpStartupInfo : STARTUPINFOW* -> 'void *'
// lpProcessInformation : PROCESS_INFORMATION* out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("ADVAPI32.dll", {
  CreateProcessAsUserW: { parameters: ["pointer", "buffer", "buffer", "pointer", "pointer", "i32", "u32", "pointer", "buffer", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation)
// hToken : HANDLE optional -> "pointer"
// lpApplicationName : LPCWSTR optional -> "buffer"
// lpCommandLine : LPWSTR optional, in/out -> "buffer"
// lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> "pointer"
// lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> "pointer"
// bInheritHandles : BOOL -> "i32"
// dwCreationFlags : PROCESS_CREATION_FLAGS -> "u32"
// lpEnvironment : void* optional -> "pointer"
// lpCurrentDirectory : LPCWSTR optional -> "buffer"
// lpStartupInfo : STARTUPINFOW* -> "pointer"
// lpProcessInformation : PROCESS_INFORMATION* out -> "pointer"
// 文字列は "buffer"。Unicode(-W) は new TextEncoder() ではなく UTF-16LE のバイト列(末尾に \x00\x00)を Uint8Array で渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t CreateProcessAsUserW(
    void* hToken,
    const uint16_t* lpApplicationName,
    uint16_t* lpCommandLine,
    void* lpProcessAttributes,
    void* lpThreadAttributes,
    int32_t bInheritHandles,
    uint32_t dwCreationFlags,
    void* lpEnvironment,
    const uint16_t* lpCurrentDirectory,
    void* lpStartupInfo,
    void* lpProcessInformation);
C, "ADVAPI32.dll");
// $ffi->CreateProcessAsUserW(hToken, lpApplicationName, lpCommandLine, lpProcessAttributes, lpThreadAttributes, bInheritHandles, dwCreationFlags, lpEnvironment, lpCurrentDirectory, lpStartupInfo, lpProcessInformation);
// hToken : HANDLE optional
// lpApplicationName : LPCWSTR optional
// lpCommandLine : LPWSTR optional, in/out
// lpProcessAttributes : SECURITY_ATTRIBUTES* optional
// lpThreadAttributes : SECURITY_ATTRIBUTES* optional
// bInheritHandles : BOOL
// dwCreationFlags : PROCESS_CREATION_FLAGS
// lpEnvironment : void* optional
// lpCurrentDirectory : LPCWSTR optional
// lpStartupInfo : STARTUPINFOW*
// lpProcessInformation : PROCESS_INFORMATION* out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Advapi32 extends StdCallLibrary {
    Advapi32 INSTANCE = Native.load("advapi32", Advapi32.class, W32APIOptions.UNICODE_OPTIONS);
    boolean CreateProcessAsUserW(
        Pointer hToken,   // HANDLE optional
        WString lpApplicationName,   // LPCWSTR optional
        char[] lpCommandLine,   // LPWSTR optional, in/out
        Pointer lpProcessAttributes,   // SECURITY_ATTRIBUTES* optional
        Pointer lpThreadAttributes,   // SECURITY_ATTRIBUTES* optional
        boolean bInheritHandles,   // BOOL
        int dwCreationFlags,   // PROCESS_CREATION_FLAGS
        Pointer lpEnvironment,   // void* optional
        WString lpCurrentDirectory,   // LPCWSTR optional
        Pointer lpStartupInfo,   // STARTUPINFOW*
        Pointer lpProcessInformation   // PROCESS_INFORMATION* out
    );
}
// Unicode(-W): WString(入力)/char[](出力)で UTF-16 をマーシャリング。
@[Link("advapi32")]
lib LibADVAPI32
  fun CreateProcessAsUserW = CreateProcessAsUserW(
    hToken : Void*,   # HANDLE optional
    lpApplicationName : UInt16*,   # LPCWSTR optional
    lpCommandLine : UInt16*,   # LPWSTR optional, in/out
    lpProcessAttributes : SECURITY_ATTRIBUTES*,   # SECURITY_ATTRIBUTES* optional
    lpThreadAttributes : SECURITY_ATTRIBUTES*,   # SECURITY_ATTRIBUTES* optional
    bInheritHandles : Int32,   # BOOL
    dwCreationFlags : UInt32,   # PROCESS_CREATION_FLAGS
    lpEnvironment : Void*,   # void* optional
    lpCurrentDirectory : UInt16*,   # LPCWSTR optional
    lpStartupInfo : STARTUPINFOW*,   # STARTUPINFOW*
    lpProcessInformation : PROCESS_INFORMATION*   # PROCESS_INFORMATION* out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef CreateProcessAsUserWNative = Int32 Function(Pointer<Void>, Pointer<Utf16>, Pointer<Utf16>, Pointer<Void>, Pointer<Void>, Int32, Uint32, Pointer<Void>, Pointer<Utf16>, Pointer<Void>, Pointer<Void>);
typedef CreateProcessAsUserWDart = int Function(Pointer<Void>, Pointer<Utf16>, Pointer<Utf16>, Pointer<Void>, Pointer<Void>, int, int, Pointer<Void>, Pointer<Utf16>, Pointer<Void>, Pointer<Void>);
final CreateProcessAsUserW = DynamicLibrary.open('ADVAPI32.dll')
    .lookupFunction<CreateProcessAsUserWNative, CreateProcessAsUserWDart>('CreateProcessAsUserW');
// hToken : HANDLE optional -> Pointer<Void>
// lpApplicationName : LPCWSTR optional -> Pointer<Utf16>
// lpCommandLine : LPWSTR optional, in/out -> Pointer<Utf16>
// lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> Pointer<Void>
// lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> Pointer<Void>
// bInheritHandles : BOOL -> Int32
// dwCreationFlags : PROCESS_CREATION_FLAGS -> Uint32
// lpEnvironment : void* optional -> Pointer<Void>
// lpCurrentDirectory : LPCWSTR optional -> Pointer<Utf16>
// lpStartupInfo : STARTUPINFOW* -> Pointer<Void>
// lpProcessInformation : PROCESS_INFORMATION* out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function CreateProcessAsUserW(
  hToken: THandle;   // HANDLE optional
  lpApplicationName: PWideChar;   // LPCWSTR optional
  lpCommandLine: PWideChar;   // LPWSTR optional, in/out
  lpProcessAttributes: Pointer;   // SECURITY_ATTRIBUTES* optional
  lpThreadAttributes: Pointer;   // SECURITY_ATTRIBUTES* optional
  bInheritHandles: BOOL;   // BOOL
  dwCreationFlags: DWORD;   // PROCESS_CREATION_FLAGS
  lpEnvironment: Pointer;   // void* optional
  lpCurrentDirectory: PWideChar;   // LPCWSTR optional
  lpStartupInfo: Pointer;   // STARTUPINFOW*
  lpProcessInformation: Pointer   // PROCESS_INFORMATION* out
): BOOL; stdcall;
  external 'ADVAPI32.dll' name 'CreateProcessAsUserW';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "CreateProcessAsUserW"
  c_CreateProcessAsUserW :: Ptr () -> CWString -> CWString -> Ptr () -> Ptr () -> CInt -> Word32 -> Ptr () -> CWString -> Ptr () -> Ptr () -> IO CInt
-- hToken : HANDLE optional -> Ptr ()
-- lpApplicationName : LPCWSTR optional -> CWString
-- lpCommandLine : LPWSTR optional, in/out -> CWString
-- lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> Ptr ()
-- lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> Ptr ()
-- bInheritHandles : BOOL -> CInt
-- dwCreationFlags : PROCESS_CREATION_FLAGS -> Word32
-- lpEnvironment : void* optional -> Ptr ()
-- lpCurrentDirectory : LPCWSTR optional -> CWString
-- lpStartupInfo : STARTUPINFOW* -> Ptr ()
-- lpProcessInformation : PROCESS_INFORMATION* out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let createprocessasuserw =
  foreign "CreateProcessAsUserW"
    ((ptr void) @-> (ptr uint16_t) @-> (ptr uint16_t) @-> (ptr void) @-> (ptr void) @-> int32_t @-> uint32_t @-> (ptr void) @-> (ptr uint16_t) @-> (ptr void) @-> (ptr void) @-> returning int32_t)
(* hToken : HANDLE optional -> (ptr void) *)
(* lpApplicationName : LPCWSTR optional -> (ptr uint16_t) *)
(* lpCommandLine : LPWSTR optional, in/out -> (ptr uint16_t) *)
(* lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> (ptr void) *)
(* lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> (ptr void) *)
(* bInheritHandles : BOOL -> int32_t *)
(* dwCreationFlags : PROCESS_CREATION_FLAGS -> uint32_t *)
(* lpEnvironment : void* optional -> (ptr void) *)
(* lpCurrentDirectory : LPCWSTR optional -> (ptr uint16_t) *)
(* lpStartupInfo : STARTUPINFOW* -> (ptr void) *)
(* lpProcessInformation : PROCESS_INFORMATION* out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library advapi32 (t "ADVAPI32.dll"))
(cffi:use-foreign-library advapi32)

(cffi:defcfun ("CreateProcessAsUserW" create-process-as-user-w :convention :stdcall) :int32
  (h-token :pointer)   ; HANDLE optional
  (lp-application-name (:string :encoding :utf-16le))   ; LPCWSTR optional
  (lp-command-line :pointer)   ; LPWSTR optional, in/out
  (lp-process-attributes :pointer)   ; SECURITY_ATTRIBUTES* optional
  (lp-thread-attributes :pointer)   ; SECURITY_ATTRIBUTES* optional
  (b-inherit-handles :int32)   ; BOOL
  (dw-creation-flags :uint32)   ; PROCESS_CREATION_FLAGS
  (lp-environment :pointer)   ; void* optional
  (lp-current-directory (:string :encoding :utf-16le))   ; LPCWSTR optional
  (lp-startup-info :pointer)   ; STARTUPINFOW*
  (lp-process-information :pointer))   ; PROCESS_INFORMATION* out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $CreateProcessAsUserW = Win32::API::More->new('ADVAPI32',
    'BOOL CreateProcessAsUserW(HANDLE hToken, LPCWSTR lpApplicationName, LPWSTR lpCommandLine, LPVOID lpProcessAttributes, LPVOID lpThreadAttributes, BOOL bInheritHandles, DWORD dwCreationFlags, LPVOID lpEnvironment, LPCWSTR lpCurrentDirectory, LPVOID lpStartupInfo, LPVOID lpProcessInformation)');
# my $ret = $CreateProcessAsUserW->Call($hToken, $lpApplicationName, $lpCommandLine, $lpProcessAttributes, $lpThreadAttributes, $bInheritHandles, $dwCreationFlags, $lpEnvironment, $lpCurrentDirectory, $lpStartupInfo, $lpProcessInformation);
# hToken : HANDLE optional -> HANDLE
# lpApplicationName : LPCWSTR optional -> LPCWSTR
# lpCommandLine : LPWSTR optional, in/out -> LPWSTR
# lpProcessAttributes : SECURITY_ATTRIBUTES* optional -> LPVOID
# lpThreadAttributes : SECURITY_ATTRIBUTES* optional -> LPVOID
# bInheritHandles : BOOL -> BOOL
# dwCreationFlags : PROCESS_CREATION_FLAGS -> DWORD
# lpEnvironment : void* optional -> LPVOID
# lpCurrentDirectory : LPCWSTR optional -> LPCWSTR
# lpStartupInfo : STARTUPINFOW* -> LPVOID
# lpProcessInformation : PROCESS_INFORMATION* out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# Unicode(-W): LPCWSTR/LPWSTR は Win32::API が UTF-16 変換を行う。

関連項目

文字セット違い
公式の関連項目
使用する型