Função MprAdminDeviceEnum (mprapi.h)

Artigo
02/29/2024

A função MprAdminDeviceEnum é chamada para enumerar dispositivos compatíveis com RAS instalados no computador que podem retornar seu nome e tipo.

Sintaxe

DWORD MprAdminDeviceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [out] LPDWORD           lpdwTotalEntries
);

Parâmetros

[in] hMprServer

Manipule para o roteador no qual executar essa chamada. Obtenha esse identificador chamando MprAdminServerConnect.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são retornadas no parâmetro lplpbBuffer . Deve ser zero.

[out] lplpbBuffer

Após a conclusão bem-sucedida, uma matriz de estruturas de MPR_DEVICE_0 que contém as informações de dispositivo compatíveis com RAS. Libere essa memória chamando MprAdminBufferFree.

[out] lpdwTotalEntries

O número de entradas do tipo MPR_DEVICE_0 no lplpbBuffer.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor	Significado
ERROR_NOT_SUPPORTED	O parâmetro dwlevel não é igual a zero.
ERROR_INVALID_PARAMETER	O parâmetro lplpbBuffer ou lpdwTotalEntries é NULL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll

Confira também

MprAdminServerConnect

Funções de administração do roteador

Referência de gerenciamento de roteador

Compartilhar via