Função CM_Get_Next_Res_Des (cfgmgr32.h)

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

Sintaxe

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

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

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

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

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

Requisitos

Confira também

CM_Get_Next_Res_Des_Ex