Função MprAdminInterfaceGetCredentialsEx (mprapi.h)
Use a função MprAdminInterfaceGetCredentialsEx para recuperar informações de credenciais estendidas para a interface especificada. Use essa função para recuperar informações de credenciais usadas para protocolos de autenticação extensíveis (EAPs).
Sintaxe
DWORD MprAdminInterfaceGetCredentialsEx(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[out] LPBYTE *lplpbBuffer
);
Parâmetros
[in] hMprServer
Identificador para um roteador. Esse identificador é obtido de uma chamada anterior para MprAdminServerConnect.
[in] hInterface
Manipule para a interface . Esse identificador é obtido de uma chamada anterior para MprAdminInterfaceCreate.
[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 ou 1, conforme listado na tabela a seguir.
| Valor | Formato de estrutura |
|---|---|
| 0 | Windows 2000 Server: MPR_CREDENTIALSEX_0 |
| 1 | Windows Server 2003 ou posterior: MPR_CREDENTIALSEX_1 |
Um valor 1 indica que as informações são uma chave pré-compartilhada para a interface, que está em um formato criptografado.
[out] lplpbBuffer
Após a conclusão bem-sucedida, um ponteiro para uma estrutura MPR_CREDENTIALSEX_0 ou MPR_CREDENTIALSEX_1 . O parâmetro dwLevel indica o tipo de estrutura. Libere a memória ocupada por essa estrutura com 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 valor hInterface é inválido. |
|
O parâmetro lplpbBuffer é NULL. |
|
Recursos insuficientes para concluir a operação. |
|
O valor dwLevel é inválido. |
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
MprAdminInterfaceGetCredentials