Função WSManPluginAuthzUserComplete (wsman.h)
Chamado do ponto de entrada do plug-in WSManPluginAuthzUser e relata uma autorização de conexão de usuário bem-sucedida ou com falha.
Sintaxe
DWORD WSManPluginAuthzUserComplete(
[in] WSMAN_SENDER_DETAILS *senderDetails,
[in] DWORD flags,
[in, optional] PVOID userAuthorizationContext,
[in, optional] HANDLE impersonationToken,
[in] BOOL userIsAdministrator,
[in] DWORD errorCode,
[in, optional] PCWSTR extendedErrorInformation
);
Parâmetros
[in] senderDetails
Um ponteiro para a estrutura de WSMAN_SENDER_DETAILS que foi passada para a chamada de plug-in WSManPluginAuthzUser .
[in] flags
Reservado para uso futuro. Deve ser definido como zero.
[in, optional] userAuthorizationContext
Especifica um contexto definido pelo plug-in usado para ajudar a acompanhar as informações de contexto do usuário. Esse contexto pode ser retornado para várias chamadas, para essa chamada ou para uma chamada de operação. O plug-in gerencia a contagem de referência para todas as chamadas. Se o registro do usuário atingir o tempo limite ou a autorização for necessária, a infraestrutura do WinRM chamará WSManPluginAuthzReleaseContext.
[in, optional] impersonationToken
Especifica a identidade do usuário. Esse parâmetro é o clientToken que foi passado para senderDetails. Se o plug-in alterar o contexto do usuário, um novo token de representação deverá ser retornado.
[in] userIsAdministrator
Defina como TRUE se o usuário for um administrador. Caso contrário, esse parâmetro será FALSE.
[in] errorCode
Relata uma autorização bem-sucedida ou com falha. Se a autorização for bem-sucedida, o código deverá ser ERROR_SUCCESS. Se o usuário não estiver autorizado a executar a operação, o erro deverá ser ERROR_ACCESS_DENIED. Se uma falha ocorrer por qualquer outro motivo, um código de erro apropriado deverá ser usado. Qualquer erro dessa chamada será enviado de volta como um pacote de falha SOAP.
[in, optional] extendedErrorInformation
Especifica um documento XML que contém informações de erro extras que precisam ser relatadas ao cliente. Esse parâmetro será ignorado se errorCode for NO_ERROR. A linguagem de interface do usuário do thread deve ser usada para localização.
Retornar valor
O método retornará ERROR_SUCCESS se tiver êxito; caso contrário, retornará ERROR_INVALID_PARAMETER. Se ERROR_INVALID_PARAMETER for retornado, o parâmetro senderDetails será NULL ou o parâmetro flags não será zero.
Comentários
Se o token de representação passado para senderDetails não for a identidade com a qual a operação deve ser executada ou se nenhum token de representação estiver disponível e o plug-in especificar uma nova identidade para realizar a solicitação, o plug-in deverá retornar a nova impersonationToken que a infraestrutura do WSMan usará para representar o cliente antes de chamar o plug-in de operação. Se um token de representação for fornecido no senderDetails e o plug-in quiser executar a operação sob essa identidade, o plug-in deverá copiar o token de representação do senderDetails para o parâmetro impersonationToken . Se o plug-in quiser realizar a solicitação no contexto do processo de host dos Serviços de Informações da Internet (IIS), o impersonationToken deverá ser NULL. Se impersonationToken for NULL, o thread representará o token de processo antes de chamar o plug-in de operação.
Se o parâmetro userIsAdministrator estiver definido como TRUE, o usuário poderá exibir e excluir shells pertencentes a diferentes usuários.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Plataforma de Destino | Windows |
| Cabeçalho | wsman.h |
| Biblioteca | WsmSvc.lib |
| DLL | WsmSvc.dll |
| Redistribuível | Windows Management Framework no Windows Server 2008 com SP2 e Windows Vista com SP2 |