Função CM_Get_Next_Res_Des_Ex (cfgmgr32.h)

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

A função CM_Get_Next_Res_Des_Ex obtém um identificador para o próximo descritor de recursos, de um tipo de recurso especificado, para uma configuração lógica em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Next_Res_Des_Ex(
  [out]           PRES_DES    prdResDes,
  [in]            RES_DES     rdResDes,
  [in]            RESOURCEID  ForResource,
  [out, optional] PRESOURCEID pResourceID,
  [in]            ULONG       ulFlags,
  [in, optional]  HMACHINE    hMachine
);

Parâmetros

[out] prdResDes

Ponteiro para um local para receber um identificador de descritor de recurso.

[in] rdResDes

Identificador fornecido pelo chamador para um descritor de recurso ou uma configuração lógica. Para obter mais informações, consulte a seção Comentários a seguir.

[in] ForResource

Identificador de tipo de recurso fornecido pelo chamador, indicando o tipo de descritor de recurso que está sendo solicitado. Essa deve ser uma das constantes prefixadas por ResType_ definidas em Cfgmgr32.h.

[out, optional] pResourceID

Ponteiro para um local para receber um identificador de tipo de recurso, se ForResourceespecificar ResType_All. Para qualquer outro valor ForResource , os chamadores devem definir isso como NULL.

[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.

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

Para enumerar os descritores de recursos de uma configuração lógica, comece chamando CM_Get_Next_Res_Des_Ex com o identificador da configuração lógica como o argumento para rdResDes. Isso obtém um identificador para o primeiro descritor de recurso do tipo especificado por ForResource. Em seguida, para cada chamada subsequente para CM_Get_Next_Res_Des_Ex, especifique o identificador de descritor obtido mais recentemente como o argumento para rdResDes. Repita até que a função retorne CR_NO_MORE_RES_DES.

Para recuperar as informações armazenadas em um descritor de recursos, chame CM_Get_Res_Des_Data_Ex.

Para modificar as informações armazenadas em um descritor de recursos, chame CM_Modify_Res_Des_Ex.

Os chamadores de CM_Get_Next_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.

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_Get_Next_Res_Des