Compartilhar via


Função WSManPluginAuthzOperationComplete (wsman.h)

Chamado do ponto de entrada do plug-in WSManPluginAuthzOperation . Ele relata uma autorização bem-sucedida ou com falha para uma operação de usuário.

Sintaxe

DWORD WSManPluginAuthzOperationComplete(
  [in]           WSMAN_SENDER_DETAILS *senderDetails,
  [in]           DWORD                flags,
  [in, optional] PVOID                userAuthorizationContext,
  [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 WSManPluginAuthzOperation .

[in] flags

Reservado para uso futuro. Deve ser 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 winrm (WinRM) chamará WSManPluginAuthzReleaseContext.

[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 (Simple Object Access Protocol).

[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.

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