Função MprAdminPortGetInfo (mprapi.h)
A função MprAdminPortGetInfo obtém informações para uma porta específica.
Sintaxe
DWORD MprAdminPortGetInfo(
[in] RAS_SERVER_HANDLE hRasServer,
[in] DWORD dwLevel,
[in] HANDLE hPort,
[out] LPBYTE *lplpbBuffer
);
Parâmetros
[in] hRasServer
Manipule para o computador servidor RAS no qual coletar informações de porta. 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 . Os valores aceitáveis para dwLevel incluem 0 e 1, conforme listado na tabela a seguir.
| Valor | Formato de estrutura |
|---|---|
| 0 | RAS_PORT_0 |
| 1 | RAS_PORT_1 |
[in] hPort
Manipule para a porta para a qual coletar informações. Obtenha esse identificador chamando MprAdminPortEnum.
[out] lplpbBuffer
Após a conclusão bem-sucedida, um ponteiro para uma estrutura que descreve a porta. Essas estruturas são do tipo RAS_PORT_0 ou RAS_PORT_1 , dependendo do valor do parâmetro dwLevel . Libere essa memória chamando MprAdminBufferFree.
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 códigos de erro a seguir.
| Valor | Significado |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
O Gerenciador de Discagem de Demanda (DDM) não está em execução, possivelmente porque o DIM (Gerenciador de Interface Dinâmica) está configurado para ser executado somente em uma LAN. |
|
Pelo menos um dos seguintes parâmetros é NULL ou não aponta para memória válida: lplpBuffer, lpdwEntriesRead ou lpdwTotalEntries. |
|
O parâmetro hPort é inválido. |
|
O parâmetro dwLevel não é zero. |
|
Um erro de MprError.h, RasError.h ou WinError.h. |
Comentários
Essa função estará disponível no Windows NT 4.0 se o RRAS redistribuível estiver instalado. No entanto, a versão do Mprapi.dll que acompanha o RRAS redistribuível exporta a função como RasAdminPortGetInfo em vez de MprAdminPortGetInfo. Portanto, ao usar o RRAS redistribuível, use LoadLibrary e GetProcAddress para acessar essa função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| 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 |