Funzione WSManPluginAuthzUserComplete (wsman.h)

Chiamato dal plug-in WSManPluginAuthzUser e segnala un'autorizzazione di connessione utente riuscita o non riuscita.

Sintassi

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

Parametri

[in] senderDetails

Puntatore alla struttura WSMAN_SENDER_DETAILS passata alla chiamata plug-in WSManPluginAuthzUser .

[in] flags

Riservato per utilizzi futuri. Deve essere impostato su zero.

[in, optional] userAuthorizationContext

Specifica un contesto definito dal plug-in usato per tenere traccia delle informazioni sul contesto utente. Questo contesto può essere restituito a più chiamate, a questa chiamata o a una chiamata di operazione. Il plug-in gestisce il conteggio dei riferimenti per tutte le chiamate. Se è necessario il timeout o la ri-autorizzazione del record utente, l'infrastruttura WinRM chiama WSManPluginAuthzReleaseContext.

[in, optional] impersonationToken

Specifica l'identità dell'utente. Questo parametro è il clientToken passato a senderDetails. Se il plug-in modifica il contesto utente, deve essere restituito un nuovo token di rappresentazione.

Nota Questo token viene rilasciato dopo il completamento dell'operazione.

 

[in] userIsAdministrator

Impostare su TRUE se l'utente è un amministratore. In caso contrario, questo parametro è FALSE.

[in] errorCode

Segnala un'autorizzazione riuscita o non riuscita. Se l'autorizzazione ha esito positivo, il codice deve essere ERROR_SUCCESS. Se l'utente non è autorizzato a eseguire l'operazione, l'errore deve essere ERROR_ACCESS_DENIED. Se si verifica un errore per qualsiasi altro motivo, deve essere usato un codice di errore appropriato. Qualsiasi errore da questa chiamata verrà inviato come pacchetto di errore SOAP.

[in, optional] extendedErrorInformation

Specifica un documento XML contenente eventuali informazioni di errore aggiuntive che devono essere segnalate al client. Questo parametro viene ignorato se errorCode è NO_ERROR. La lingua dell'interfaccia utente del thread deve essere usata per la localizzazione.

Valore restituito

Il metodo restituisce ERROR_SUCCESS se ha esito positivo; in caso contrario, restituisce ERROR_INVALID_PARAMETER. Se ERROR_INVALID_PARAMETER viene restituito, il parametro senderDetails era NULL o il parametro flags non era zero.

Commenti

Se il token di rappresentazione passato a senderDetails non è l'identità con cui eseguire l'operazione oppure se non è disponibile alcun token di rappresentazione e il plug-in specifica una nuova identità per eseguire la richiesta, il plug-in deve restituire la nuova rappresentazioneToken che l'infrastruttura WSMan userà per rappresentare il client prima di chiamare nel plug-in dell'operazione. Se viene fornito un token di rappresentazione nei mittentiDetails e il plug-in vuole eseguire l'operazione in tale identità, il plug-in deve copiare il token di rappresentazione dai mittentiDetails nel parametro impersonationToken . Se il plug-in vuole eseguire la richiesta nel contesto del processo host di Internet Information Services (IIS), la rappresentazioneToken deve essere NULL. Se la rappresentazioneToken è NULL, il thread rappresenta il token di processo prima di chiamare il plug-in dell'operazione.

Se il parametro userIsAdministrator è impostato su TRUE, l'utente può visualizzare ed eliminare shell di proprietà di utenti diversi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Libreria	WsmSvc.lib
DLL	WsmSvc.dll
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2 e Windows Vista con SP2