função CM_Get_Res_Des_Data_Size_Ex (cfgmgr32.h)

  • Artigo

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

A função CM_Get_Res_Des_Data_Size_Ex obtém o tamanho do buffer necessário para manter as informações contidas em um descritor de recurso especificado em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size_Ex(
  [out]          PULONG   pulSize,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[out] pulSize

Endereço fornecido pelo chamador de um local para receber o tamanho do buffer necessário.

[in] rdResDes

Identificador fornecido pelo chamador para um descritor de recursos, obtido por uma chamada anterior para CM_Get_Next_Res_Des_Ex.

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

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
 

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

O valor de tamanho retornado representa o tamanho da estrutura de recursos apropriada (consulte CM_Add_Res_Des_Ex). Se o descritor de recursos residir em uma lista de requisitos de recurso, o tamanho retornado incluirá o tamanho da estrutura de recursos e o espaço alocado para matrizes de intervalo associadas.

A funcionalidade para acessar computadores remotos foi removida em sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do 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_Get_Res_Des_Data_Size