Compartilhar via

WSMAN_PLUGIN_AUTHORIZE_USER função de retorno de chamada (wsman.h)

  • Artigo

Autoriza uma conexão. O plug-in deve verificar se esse usuário tem permissão para executar quaisquer operações. Se o usuário tiver permissão para executar operações, o plug-in deverá relatar um êxito. Se o usuário não tiver permissão para executar qualquer tipo de operação, uma falha deverá ser retornada.

Cada nova conexão não precisa ser autorizada. Depois que um usuário tiver sido autorizado a se conectar, um registro de usuário será criado para acompanhar as atividades do usuário. Embora esse registro exista, todas as novas conexões serão autorizadas automaticamente. O registro do usuário terá um tempo limite após um período configurável depois que nenhuma atividade for detectada.

O nome do ponto de entrada da DLL para esse método deve ser WSManPluginAuthzUser.

Sintaxe

WSMAN_PLUGIN_AUTHORIZE_USER WsmanPluginAuthorizeUser;

void WsmanPluginAuthorizeUser(
  [in] PVOID pluginContext,
  [in] WSMAN_SENDER_DETAILS *senderDetails,
  [in] DWORD flags
)
{...}

Parâmetros

[in] pluginContext

Especifica o contexto que foi retornado por uma chamada para WSManPluginStartup. Esse parâmetro representa uma inicialização de aplicativo específica de um plug-in WinRM.

[in] senderDetails

Um ponteiro para a estrutura WSMAN_SENDER_DETAILS que especifica as informações de identificação do usuário a ser autorizado.

[in] flags

Reservado para uso futuro. Deve ser definido como zero.

Valor retornado

Nenhum

Comentários

O plug-in deve chamar WSManPluginAuthzUserComplete para relatar que o usuário foi autorizado com êxito com NO_ERROR ou que o usuário não foi autorizado com ERROR_ACCESS_DENIED. Um erro ERROR_WSMAN_REDIRECT_REQUIRED deverá ser relatado se um redirecionamento HTTP for necessário para esse usuário e o novo URI HTTP deverá ser registrado em extendedErrorInformation do método WSManPluginAuthzUserComplete . Todos os outros erros relatam uma falha no cliente, mas nenhuma informação específica é relatada.

Requisitos

   
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wsman.h
Redistribuível Windows Management Framework no Windows Server 2008 com SP2, Windows Vista com SP1 e Windows Vista com SP2