CM_Get_Next_Log_Conf函式 (cfgmgr32.h)
CM_Get_Next_Log_Conf函式會取得與本機電腦上特定裝置實例相關聯的下一個邏輯組態。
語法
CMAPI CONFIGRET CM_Get_Next_Log_Conf(
[out, optional] PLOG_CONF plcLogConf,
[in] LOG_CONF lcLogConf,
[in] ULONG ulFlags
);
參數
[out, optional] plcLogConf
要接收邏輯組態控制碼的位置位址,或 Null。 (請參閱下列一節。
[in] lcLogConf
呼叫端提供的邏輯組態控制碼。 此控制碼先前必須藉由呼叫下列其中一個函式來取得:
CM_Get_Next_Log_Conf
[in] ulFlags
未使用,必須是零。
傳回值
如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h中定義的其中一個CR_前置錯誤碼。
備註
若要列舉與裝置實例相關聯的邏輯組態,請呼叫 CM_Get_First_Log_Conf 以取得指定之組態類型的第一個邏輯組態,然後重複呼叫 CM_Get_Next_Log_Conf ,直到傳回CR_NO_MORE_LOG_CONF為止。
呼叫CM_Add_Empty_Log_Conf或CM_Free_Log_Conf可能會使從先前呼叫CM_Get_Next_Log_Conf取得的控制碼失效。 因此,如果您想要在呼叫 CM_Add_Empty_Log_Conf 或 CM_Free_Log_Conf之後取得邏輯組態,您的程式碼必須再次呼叫 CM_Get_First_Log_Conf 並從第一個設定開始。
呼叫CM_Free_Log_Conf_Handle,必須明確釋放在CM_Free_Log_Conf_Handle中接收的控制碼。
如果呼叫 CM_Get_Next_Log_Conf,並將CM_Get_Next_Log_Conf設定為Null,則不會傳回任何控制碼。 這可讓您使用傳回狀態來判斷設定是否存在,而不需要後續釋放控制碼。
規格需求
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
程式庫 | Cfgmgr32.lib |
Dll | Cfgmgr32.dll |