WSManPluginAuthzUserComplete 함수(wsman.h)

  • 아티클

WSManPluginAuthzUser 플러그 인 진입점에서 호출되고 성공적인 사용자 연결 권한 부여 또는 실패한 사용자 연결 권한 부여를 보고합니다.

구문

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
);

매개 변수

[in] senderDetails

WSManPluginAuthzUser 플러그 인 호출에 전달된 WSMAN_SENDER_DETAILS 구조체에 대한 포인터입니다.

[in] flags

다음에 사용하도록 예약됩니다. 0으로 설정해야 합니다.

[in, optional] userAuthorizationContext

사용자 컨텍스트 정보를 추적하는 데 사용되는 플러그 인 정의 컨텍스트를 지정합니다. 이 컨텍스트는 여러 호출, 이 호출 또는 작업 호출로 반환될 수 있습니다. 플러그 인은 모든 호출에 대한 참조 계산을 관리합니다. 사용자 레코드가 시간 초과되거나 다시 권한 부여가 필요한 경우 WinRM 인프라는 WSManPluginAuthzReleaseContext를 호출합니다.

[in, optional] impersonationToken

사용자의 ID를 지정합니다. 이 매개 변수는 senderDetails에 전달된 clientToken입니다. 플러그 인이 사용자 컨텍스트를 변경하는 경우 새 가장 토큰이 반환되어야 합니다.

참고 이 토큰은 작업이 완료된 후 해제됩니다.
 

[in] userIsAdministrator

사용자가 관리자인 경우 TRUE 로 설정합니다. 그렇지 않으면 이 매개 변수는 FALSE입니다.

[in] errorCode

성공적인 권한 부여 또는 실패한 권한 부여를 보고합니다. 권한 부여에 성공하면 코드를 ERROR_SUCCESS 합니다. 사용자에게 작업을 수행할 권한이 없는 경우 오류가 ERROR_ACCESS_DENIED 합니다. 다른 이유로 인해 오류가 발생하면 적절한 오류 코드를 사용해야 합니다. 이 호출의 오류는 SOAP 오류 패킷으로 다시 전송됩니다.

[in, optional] extendedErrorInformation

클라이언트에 보고해야 하는 추가 오류 정보가 포함된 XML 문서를 지정합니다. errorCode가 NO_ERROR 경우 이 매개 변수는 무시됩니다. 스레드의 사용자 인터페이스 언어를 지역화에 사용해야 합니다.

반환 값

메서드는 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 ERROR_INVALID_PARAMETER 반환합니다. ERROR_INVALID_PARAMETER 반환되면 senderDetails 매개 변수가 NULL이거나 flags 매개 변수가 0이 아닙니다.

설명

senderDetails에 전달된 가장 토큰이 작업을 수행해야 하는 ID가 아니거나 가장 토큰을 사용할 수 없고 플러그 인이 요청을 수행할 새 ID를 지정하는 경우 플러그 인은 WSMan 인프라가 작업 플러그 인을 호출하기 전에 클라이언트를 가장하는 데 사용할 새 impersonationToken을 반환해야 합니다. 가장 토큰이 senderDetails 에 제공되고 플러그 인이 해당 ID에서 작업을 수행하려는 경우 플러그 인은 senderDetails 에서 impersonationToken 매개 변수로 가장 토큰을 복사해야 합니다. 플러그 인이 IIS(인터넷 정보 서비스) 호스트 프로세스의 컨텍스트에서 요청을 수행하려는 경우 impersonationToken 은 NULL이어야 합니다. impersonationToken이 NULL인 경우 스레드는 작업 플러그 인을 호출하기 전에 프로세스 토큰을 가장합니다.

userIsAdministrator 매개 변수가 TRUE로 설정된 경우 사용자는 다른 사용자가 소유한 셸을 보고 삭제할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7
지원되는 최소 서버 Windows Server 2008 R2
대상 플랫폼 Windows
헤더 wsman.h
라이브러리 WsmSvc.lib
DLL WsmSvc.dll
재배포 가능 파일 SP2가 있는 Windows Server 2008 및 WINDOWS Vista SP2의 Windows Management Framework