IDebugDataSpaces4：：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

指定要針對系統句柄傳回的數據類型。 下表包含有效的值，以及對應的傳回類型：

值 Description
DEBUG_HANDLE_DATA_TYPE_BASIC 傳回系統物件的基本資訊。

在此情況下，您可以將自變數 Buffer 視為具有類型 PDEBUG_HANDLE_DATA_BASIC。
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME 傳回物件類型的名稱。 例如，「行程」或「線程」。

在此情況下，您可以將 自變數 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 轉換成上表中指定的類型來存取。

如果 Buffer 是 NULL，則不會傳回這項資訊。

[in] BufferSize

指定緩衝區 緩衝區位元組的大小。 這是將傳回的最大位元元組數。

[out, optional] DataSize

以位元組為單位接收數據的大小。 如果 DataSize 為 NULL，則不會傳回這項資訊。

傳回值

傳回碼 描述
S_OK
 此方法成功。
 

這個方法也可以傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。

備註

這個方法僅適用於使用者模式偵錯。

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

處理

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4