Função CM_Add_Res_Des_Ex (cfgmgr32.h)

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Add_Res_Des .]

A função CM_Add_Res_Des_Ex adiciona um descritor de recurso a uma configuração lógica. A configuração lógica pode estar no computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Add_Res_Des_Ex(
  [out, optional] PRES_DES   prdResDes,
  [in]            LOG_CONF   lcLogConf,
  [in]            RESOURCEID ResourceID,
  [in]            PCVOID     ResourceData,
  [in]            ULONG      ResourceLen,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parâmetros

[out, optional] prdResDes

Ponteiro para um local para receber um identificador para o novo descritor de recursos.

[in] lcLogConf

Identificador fornecido pelo chamador para a configuração lógica à qual o descritor de recursos deve ser adicionado. 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] ResourceID

Identificador de tipo de recurso fornecido pelo chamador, que identifica o tipo de estrutura fornecido por ResourceData. Essa deve ser uma das constantes prefixadas ResType_ definidas em Cfgmgr32.h.

[in] ResourceData

Ponteiro fornecido pelo chamador para uma das estruturas de recursos listadas na tabela a seguir.

[in] ResourceLen

Comprimento fornecido pelo chamador da estrutura apontada por ResourceData.

[in] ulFlags

Não usado, deve ser zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine ou NULL.

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.

Comentários

Os chamadores de CM_Add_Res_Des_Ex devem chamar CM_Free_Res_Des_Handle para desalocar o identificador do descritor de recursos, depois que ele não for mais necessário.

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

A funcionalidade para acessar computadores remotos foi removida em Windows 8 e Windows Server 2012 e sistemas operacionais posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Requisitos

Confira também

CM_Add_Res_Des

CM_Free_Res_Des_Handle