NdisOpenConfigurationKeyByName 函式 (ndis.h)

發行項
02/26/2024

NdisOpenConfigurationKeyByName 函式會開啟指定開啟登錄機碼的具名子機碼，該機碼是由呼叫端提供的句柄所指定。

語法

void NdisOpenConfigurationKeyByName(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  PNDIS_STRING SubKeyName,
  [out] PNDIS_HANDLE SubKeyHandle
);

參數

[out] Status

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

NDIS_STATUS_SUCCESS

NDIS 已初始化為 SubKeyName 所指定的子機碼 。

NDIS_STATUS_FAILURE

無法開啟金鑰。

[in] ConfigurationHandle

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

[in] SubKeyName

NDIS_STRING型別的指標，其中包含所提供之呼叫端提供的計數位符串系統預設字元集中，指定要開啟之登錄子機碼的名稱。對於 Microsoft Windows 2000 和更新版本的驅動程式，此字串包含 Unicode 字元。也就是說，對於 Windows 2000 和更新版本，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。

[out] SubKeyHandle

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

傳回值

無

備註

NdisOpenConfigurationKeyByName 可讓驅動程式存取儲存在登錄中具名子機碼中的組態資訊。

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

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

規格需求

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