(dbgeng.h) IDebugDataSpaces2：：ReadHandleData 方法

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