NdisOpenConfigurationKeyByIndex 函式 (ndis.h)

發行項
03/01/2024

NdisOpenConfigurationKeyByIndex 函式會開啟由呼叫端提供的句柄所指定之已開啟登錄機碼的子機碼。

語法

void NdisOpenConfigurationKeyByIndex(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  ULONG        Index,
  [out] PNDIS_STRING KeyName,
  [out] PNDIS_HANDLE KeyHandle
);

參數

[out] Status

呼叫端提供之變數的指標，在此變數中，此函式會傳回其嘗試開啟指定登錄機碼的狀態。可能的傳回值為下列其中一項：

NDIS_STATUS_SUCCESS

NDIS 已初始化為 KeyName 和 Index 所指定的子機碼。

NDIS_STATUS_FAILURE

無法開啟金鑰。

[in] ConfigurationHandle

要開啟子機碼之登錄機碼的句柄。一般而言， ConfigurationHandle 會由傳回 NdisOpenConfigurationEx 函式。

[in] Index

要開啟之子機碼的索引。這個以零起始的值會指定要在已以 ConfigurationHandle 開啟的索引鍵底下開啟的子機碼。

[out] KeyName

NDIS_STRING類型的指標，其中包含呼叫端提供的緩衝區，在此緩衝區中，此函式會傳回系統默認字元集中的計數位符串。如果呼叫成功，此字串會指定已開啟之子機碼的名稱。對於 Microsoft Windows 2000 和更新版本的驅動程式，此字串包含 Unicode 字元。也就是說，對於 Windows 2000 和更新版本，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。

[out] KeyHandle

呼叫端所提供變數的指標，如果呼叫成功，此函式會傳回開啟之子機碼的句柄。

傳回值

無

備註

NdisOpenConfigurationKeyByIndex 可讓驅動程式存取其安裝檔案儲存在登錄子機碼中的組態資訊。

請注意，傳入至 NdisOpenConfigurationKeyByIndex 的 ConfigurationHandle 可以是呼叫端已開啟之登錄機碼的任何有效句柄。 NdisOpenConfigurationKeyByIndex 會傳回相對於任何有效子機碼的組態資訊
ConfigurationHandle 。

由於 NdisOpenConfigurationKeyByIndex 會透過索引參考子機碼，因此驅動程式不需要指定子機碼名稱。驅動程式可以在遞增索引之後重複呼叫 NdisOpenConfigurationKeyIndex ，以排序一組登錄子機碼，直到函式傳回NDIS_STATUS_FAILURE為止，藉此表示沒有其他子機碼可供開啟。

在驅動程式取用且可能修改儲存在登錄中的組態信息之後，它必須呼叫 NdisCloseConfiguration 函式來釋放從 NdisOpenConfigurationKeyByIndex 取得的句柄。 NdisCloseConfiguration 也會釋放為驅動程式呼叫 NdisReadConfiguration、NdisReadNetworkAddress 或 NdisWriteConfiguration 函式配置給 NdisOpenConfigurationKeyByIndex 傳回之 SubKeyHandle 的任何暫存記憶體。

規格需求

需求	值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式， (請參閱 Windows Vista 中的 NdisOpenConfigurationKeyByIndex (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式，請參閱 Windows XP 中的 NdisOpenConfigurationKeyByIndex (NDIS 5.1) ) 。
目標平台	Universal
標頭	ndis.h (包含 Ndis.h)
程式庫	Ndis.lib
IRQL	< DISPATCH_LEVEL
DDI 合規性規則	Irql_Miscellaneous_Function (ndis)