次の方法で共有

IDebugDataSpaces2::ReadHandleData メソッド (dbgeng.h)

  • [アーティクル]

ReadHandleData メソッドは、システム ハンドルによって指定されたシステム オブジェクトに関する情報を取得します。

構文

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

パラメーター

[in] Handle

データが要求されるオブジェクトのシステム ハンドルを指定します。 システム ハンドルの詳細については、「ハンドル」を参照してください。

[in] DataType

システム ハンドルに返すデータ型を指定します。 次の表に、有効な値と、対応する戻り値の型を示します。

価値 形容
DEBUG_HANDLE_DATA_TYPE_BASIC システム オブジェクトに関する基本情報を返します。

この場合、Buffer 引数は型 PDEBUG_HANDLE_DATA_BASICを持つと見なすことができます。
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME オブジェクト型の名前を返します。 たとえば、"Process" や "Thread" などです。

この場合、Buffer 引数は PSTR 型と見なすことができます。
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME オブジェクトの名前を返します。 これには、オブジェクト ディレクトリ内の場所が含まれます。

この場合、Buffer 引数は PSTR 型と見なすことができます。
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT オブジェクトが保持するハンドルの数を返します。 これは、DEBUG_HANDLE_DATA_BASICフィールドに似ています。HandleCountをします。

この場合、Buffer 引数は PULONG 型と見なすことができます。
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE オブジェクト型の名前を返します。

この場合、Buffer 引数は PWSTR 型であると見なすことができます。
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE オブジェクトの名前を返します。

この場合、Buffer 引数は PWSTR 型であると見なすことができます。

[out, optional] Buffer

オブジェクト データを受け取ります。 メソッドが正常に完了すると、このバッファーの内容は、上記の表で指定された型 Buffer キャストすることによってアクセスできます。

バッファー が NULL 場合、この情報は返されません。

[in] BufferSize

バッファー バッファーのサイズをバイト単位で指定します。 これは、返される最大バイト数です。

[out, optional] DataSize

データのサイズをバイト単位で受け取ります。 DataSize が NULL 場合、この情報は返されません。

戻り値

リターン コード 形容
S_OK
 メソッドが成功しました。
 

このメソッドは、エラー値を返すこともできます。 詳細については 戻り値の を参照してください。

備考

このメソッドは、ユーザー モード デバッグでのみ使用できます。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

ハンドル

IDebugDataSpaces2 の

IDebugDataSpaces3 を する

IDebugDataSpaces4