função CM_Free_Log_Conf (cfgmgr32.h)

  • Artigo

A função CM_Free_Log_Conf remove uma configuração lógica e todos os descritores de recursos associados do computador local.

Sintaxe

CMAPI CONFIGRET CM_Free_Log_Conf(
  [in] LOG_CONF lcLogConfToBeFreed,
  [in] ULONG    ulFlags
);

Parâmetros

[in] lcLogConfToBeFreed

Identificador fornecido pelo chamador para uma configuração lógica. Esse identificador deve ter sido obtido anteriormente chamando uma das seguintes funções:

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[in] ulFlags

Não usado, deve ser zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Nota Começando com Windows 8, CM_Free_Log_Conf retorna CR_CALL_NOT_IMPLEMENTED quando usado em um cenário Wow64. Para solicitar informações sobre os recursos de hardware em um computador local, é necessário implementar uma versão nativa da arquitetura do aplicativo usando as APIs de recurso de hardware. Por exemplo: um aplicativo AMD64 para sistemas AMD64.
 

Comentários

Chamar CM_Free_Log_Conf pode fazer com que os identificadores retornados por CM_Get_First_Log_Conf e CM_Get_Next_Log_Conf se tornem inválidos. Portanto, se você quiser obter configurações lógicas depois de chamar CM_Free_Log_Conf, seu código deverá chamar CM_Get_First_Log_Conf novamente e começar na primeira configuração.

Observe que chamar CM_Free_Log_Conf libera a configuração, mas não o identificador da configuração. Para liberar o identificador, chame CM_Free_Log_Conf_Handle.

Os chamadores dessa função devem ter SeLoadDriverPrivilege. (Os privilégios são descritos na documentação do SDK do Microsoft Windows.)

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_Free_Log_Conf_Ex