NdisOpenConfigurationKeyByIndex 函式 (ndis.h)
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) |