QueryActCtxW

QueryActCtxW 関数は、アクティベーションコンテキストを照会する。

QueryActCtxW dwFlags, hActCtx, pvSubInstance, ulInfoClass, pvBuffer, cbBuffer, pcbWrittenOrRequired

dwFlags : [int] このパラメータには、次のフラグビットのいずれかを設定する。
hActCtx : [intptr] 照会対象のアクティベーションコンテキストへのハンドル。
pvSubInstance : [intptr] アクティベーションコンテキスト内のアセンブリ、またはアセンブリとファイルの組み合わせのインデックス。pvSubInstance の意味は ulInfoClass パラメータの値で指定されるオプションに依存する。このパラメータは NULL でもよい。
ulInfoClass : [int] このパラメータには、次の表に示す値のみを指定できる。
pvBuffer : [intptr] 返される情報を保持するバッファへのポインタ。このパラメータは省略可能。pvBuffer が NULL の場合、cbBuffer は 0 でなければならない。pvBuffer が指すバッファのサイズが小さすぎる場合、QueryActCtxW は ERROR_INSUFFICIENT_BUFFER を返し、バッファにはデータが書き込まれない。必要なバッファサイズを決定する方法については Remarks セクションを参照。
cbBuffer : [int] pvBuffer が指すバッファのサイズ(バイト単位)。このパラメータは省略可能。
pcbWrittenOrRequired : [var] 書き込まれた、または必要となるバイト数。pcbWrittenOrRequired は pvBuffer が NULL の場合にのみ NULL にできる。pcbWrittenOrRequired が非 NULL の場合、返されるバッファを格納するために必要なバイト数が設定される。

(プラグイン / モジュール : kernel32.dll)

解説

QueryActCtxW 関数は、アクティベーションコンテキストを照会する。

[戻り値]
関数が成功した場合は TRUE を返す。そうでない場合は FALSE を返す。この関数は GetLastError
で取得可能なエラーを設定する。例については Retrieving the Last-Error Code
を参照。エラーコードの完全な一覧は System Error Codes を参照。

[備考]
cbBuffer パラメータは pvBuffer が指すバッファのサイズをバイト単位で指定する。pvBuffer が NULL
の場合、cbBuffer は 0 でなければならない。pcbWrittenOrRequired は pvBuffer が NULL
の場合のみ NULL にできる。pcbWrittenOrRequired が戻り時に非 NULL
の場合、返される情報を格納するために必要なバイト数が設定される。返される情報データが与えられたバッファより大きい場合、QueryActCtxW
は ERROR_INSUFFICIENT_BUFFER を返し、pvBuffer
が指すバッファにはデータが書き込まれない。次の例では、まず小さなバッファで呼び出し、バッファが小さすぎる場合に再度呼び出す方法を示す。
（以下省略）

情報