estrutura SECURITY_MESSAGE (rasshost.h)

Artigo
03/05/2024

A estrutura SECURITY_MESSAGE é usada com a função RasSecurityDialogComplete para indicar os resultados de uma transação de autenticação DLL de segurança RAS.

Sintaxe

typedef struct _SECURITY_MESSAGE {
  DWORD dwMsgId;
  HPORT hPort;
  DWORD dwError;
  CHAR  UserName[UNLEN + 1];
  CHAR  Domain[DNLEN + 1];
} SECURITY_MESSAGE, *PSECURITY_MESSAGE;

Membros

dwMsgId

Indica se o servidor RAS deve conceder acesso ao usuário remoto. Esse membro pode ser um dos valores a seguir.

Valor	Significado
SECURITYMSG_SUCCESS	A DLL de segurança autenticou com êxito o usuário remoto identificado pelo membro UserName . O servidor RAS continua com sua autenticação PPP.
SECURITYMSG_FAILURE	A DLL de segurança negou acesso ao usuário remoto identificado pelo membro UserName . O servidor RAS trava a chamada e registra a autenticação com falha no log de eventos.
SECURITYMSG_ERROR	Ocorreu um erro que impediu a validação do usuário remoto. O servidor RAS trava a chamada e registra o erro no log de eventos.

hPort

Especifica o identificador de porta que o servidor RAS passou para a DLL de segurança na chamada RasSecurityDialogBegin para essa transação de autenticação.

dwError

Especifica um código de erro. Se dwMsgId for SECURITYMSG_ERROR, defina dwError como um dos códigos de erro não zero definidos em Winerror.h ou Raserror.h. O servidor RAS registra esse código de erro no log de eventos. Se o membro dwMsgId indicar êxito ou falha, defina dwError como zero.

UserName[UNLEN + 1]

Especifica o nome do usuário remoto se dwMsgId for SECURITYMSG_SUCCESS ou SECURITYMSG_FAILURE. Essa cadeia de caracteres poderá estar vazia se dwMsgId estiver SECURITYMSG_ERROR.

Domain[DNLEN + 1]

Especifica o nome do domínio de logon para o usuário remoto se dwMsgId for SECURITYMSG_SUCCESS ou SECURITYMSG_FAILURE. Essa cadeia de caracteres poderá estar vazia se dwMsgId estiver SECURITYMSG_ERROR.

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]
Cabeçalho	rasshost.h

Confira também

Estruturas de administração do servidor RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

Visão geral do RAS (Serviço de Acesso Remoto)

Compartilhar via