Função MprAdminInterfaceSetCredentialsEx (mprapi.h)

Artigo
03/05/2024

Use a função MprAdminInterfaceSetCredentialsEx para definir informações de credenciais estendidas para uma interface. Use essa função para definir informações de credenciais usadas para protocolos de autenticação extensíveis (EAPs).

Sintaxe

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

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 estruturadas no parâmetro lpbBuffer . Os valores aceitáveis para dwLevel incluem 0 ou 1, conforme listado na tabela a seguir. Um valor de 1 indica que as informações são uma chave pré-compartilhada para a interface.

Valor	Formato de estrutura
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 ou posterior: MPR_CREDENTIALSEX_1

[in] lpbBuffer

Um ponteiro para uma estrutura MPR_CREDENTIALSEX_0 ou MPR_CREDENTIALSEX_1 . O parâmetro dwLevel indica o tipo de estrutura.

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
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_INVALID_HANDLE	O valor hInterface é inválido.
ERROR_INVALID_PARAMETER	O parâmetro lplpbBuffer é NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_NOT_SUPPORTED	O valor dwLevel é inválido.

Comentários

Para excluir uma chave pré-compartilhada, chame MprAdminInterfaceSetCredentials com o membro dwSize da estrutura MPR_CREDENTIALSEX_1 definida como zero.

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